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内 容 简 介 


本 书 以 SL4A 技术 为 核心 内 容 , 以 JavaScript 为 主要 开发 语言 ,系统 地 阐述 了 Android 脚本 开发 技 
术 。 本 书 共 13 章 , 第 1 章 对 Android 发 展 前 景 ,历史 发 展 .SL4A 工作 原理 和 脚本 开发 环境 等 内 容 进 行 
了 详细 介绍 。 第 2 章 对 JavaScript 脚本 的 变量 .数据 结构 .控制 语句 、 函 数 .数组 ,对象 和 Rhino 引擎 等 内 
容 进 行 了 详细 介绍 。 第 3 一 6 章 详细 介绍 了 用 户 屏幕 界面 技术 ,包括 对 话 框 ` 屏 幕布 局 .屏幕 控件 和 事 
件 。 第 7 章 介 绍 了 数据 持久 化 技术 ,包括 首选 项 ,数据库 ,文件 和 网 络 。 第 8 章 对 Android 的 4 大 组 件 进 
行 了 详细 介绍 ,包括 意图 、 活 动 ,广播 ,内容 和 服务 。 第 9 章 对 扫描 码 .浏览 任务 .应 用 管理 、 唤 醒 锁 .屏幕 
设置 和 飞行 模式 等 技术 内 容 进行 了 详细 介绍 。 第 10 章 对 电话 短信、 蓝牙 和 WiFi 通信 以 及 指南 针 、 
GPS 方向 ,加 速度 和 磁力 等 传感器 技术 进行 了 介绍 。 第 11 章 对 视频 拍摄 媒体 录制 媒体 播放 .语音 合 
成 和 语音 识别 进行 了 详细 介绍 。 第 12 章 介 绍 了 混合 开发 模式 ,并 介绍 HTML5 在 混合 开发 模式 中 的 应 
用 。 第 13 章 对 Android 脚本 应 用 运行 方式 和 开发 常见 问题 进行 了 介绍 。 

本 书 涵盖 Android 众多 常用 开发 技术 ,对 开发 技术 给 出 了 应 用 背景 .工作 原理 ,开发 方法 和 应 用 范 
例 , 每 个 应 用 范例 都 有 翔实 可 运行 的 代码 ,实例 代码 附 有 详细 注释 、 分 析 说 明 及 运行 效果 图 。 

本 书 适用 于 高 等 院 校 计算 机 、 软 件 工程 和 软件 技术 专业 大 专 生 、 本 科 生 和 研究 生 , 同 时 可 供 对 
JavaScript 等 脚本 比较 熟悉 的 开发 人 员 和 研究 人 员 等 参考 和 研究 。 
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Java 语言 是 当今 Android 移动 互联 网 应 用 软件 主流 开发 语言 ,由 于 其 严格 遵守 规范 
等 特性 ,即使 简单 的 应 用 也 需要 复杂 的 设计 等 约束 ,因此 严重 制约 了 移动 互联 网 应 用 软件 
开发 的 发 展 。SL4A(Scripting Layer for Android) 是 Android 系统 中 的 一 个 应 用 性 组 件 ， 
SL4A 能 跨 数 十 种 脚本 语言 提供 Android 原生 态 服 务 ,SL4A 移动 互联 网 应 用 软件 是 指 基 
于 SL4A 使 用 脚本 语言 开发 的 移动 互联 网 应 用 软件 。 当 前 脚本 语言 数量 庞大 ,包括 常见 
的 JavaScript、VBScript、.PHP,、Perl 和 Ruby 等 ,这 些 脚本 语言 具有 开发 快速 和 学 习 成 本 
低 等 特点 。JavaScript 是 一 种 被 广泛 使 用 的 脚本 语言 ,其 作为 客户 端 开发 语言 在 Web 应 
用 中 得 到 普遍 使 用 。 基 于 JavaScript 研究 SL4A 移动 互联 网 应 用 软件 开发 技术 其 意义 是 
重大 的 , 它 可 以 打破 Java 是 Android 移动 互联 网 应 用 软件 唯一 主流 语言 的 局 面 ,让 移动 
互联 网 软件 开发 走向 开发 语言 多 元 化 道路 ,能 让 更 多 的 Web 开发 人 员 快 速 , 轻 松 地 掌握 
Android 应 用 开发 技术 ,能 让 从 事 Web 产品 开发 的 企业 快速 转型 进入 Android 产品 开发 
领域 ,能 为 我 国 移动 互联 网 产业 快速 发 展 提供 助力 。 为 了 落实 这 个 有 意义 的 想法 ,我们 对 
Android 脚本 开发 技术 进行 了 研究 和 探讨 。 

本 书面 向 Android 开发 入门 者 ,通过 通俗 易 懂 的 语言 和 丰富 多 彩 的 实例 ,比较 系统 地 
阐述 了 使 用 JavaScript 开发 Android 移动 互联 网 应 用 软件 需要 掌握 的 SL4A 技术 。 本 书 
以 先 易 后 难 原则 , 先 讲述 JavaScript 基础 ,再 按 用 户 界面 ,数据 持久 化 、 四 大 组 件 、 通 信 , 传 
感 器 、 多 媒体 和 软件 发 布 为 主线 阐述 SL4A 技术 。 内 容 突 出 “新 颖 、 系 统 和 实践 ”的 特点 ， 
具体 特色 如 下 : 

(1) 内 容 新 颖 和 系统 。 基 于 JavaScript 对 SL4A 技术 进行 了 探讨 和 研究 ,系统 阐述 了 
SL4A 工作 原理 、 开 发 环境 、 用 户 界面 .数据 持久 化 、 四 大 组 件 、 通 用 任务 、 传 感 器 ,多 媒体 、 
脚本 应 用 发 布 和 常见 开发 问题 等 开发 内 容 。 

(2) 实用 性 和 实践 性 强 。 通 过 实例 分 析 和 实现 ,读者 能 深刻 理解 SL4A 开发 技 
术 ,能 使 用 JavaScript 脚本 开发 Android 应 用 ,能 使 用 本 书 中 的 实例 快速 地 完成 项 目 

(3) 附 有 代码 。 每 个 实例 都 附 有 源 代码 ,可 直接 运行 帮助 读者 学 习 。 

本 书 能 让 读者 以 较 短 学 习 周 期 和 较 低 学 习 成 本 轻松 领会 SL4A 开发 技术 的 精髓 , 快 
速 掌握 使 用 JavaScript 开发 Android 移动 互联 网 应 用 软件 的 开发 技能 ,能 举一反三 把 
SL4A 技术 应 用 到 其 他 脚本 语言 。 

本 书 第 1.7~10 章 由 邢 益 良 编写 ,第 3 一 6 章 由 雷 华军 编写 ,第 2.11 一 13 章 由 裴 云 编 
写 。 本 书 在 编写 过 程 中 ,作者 参考 了 大 量 书籍 文献 和 专业 网 站 文章 ,同时 ,也 融入 了 作者 
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第 上 党 
Android 开发 概述 


1.1 Andrwid 及 其 前 景 


Android 一 词 最 先 出 现在 法 国 作家 利 尔 。 亚当 1886 年 发 表 的 科幻 小 说 (未 来 夏娃 》 
中 ,他 将 外 表 像 人 类 的 机 器 起 名 为 Android。Android 中 文 名 叫 * 安 卓 ” 或 “ 安 致 "。Android 
系统 最 先 由 一 家 叫做 Android 的 公司 研发 .该 公司 的 创办 者 是 美国 人 Andy Rubin。 谷 歌 公 
司 在 2005 年 收购 了 这 家 高 科技 企业 , Android 系统 也 开始 由 谷歌 接手 研发 。Android 系统 负 
责 人 以 及 Android 公司 的 Andy Rubin 成 为 谷歌 公司 的 工程 部 副 总 裁 , 继 续 负责 Android 项 
目的 研发 工作 。Android 是 Google 公司 于 2007 年 11 月 宣布 的 基于 Linux 平台 的 开源 移动 
操作 系统 的 名 称 。Android 号 称 是 首 个 为 移动 终端 打造 的 真正 开放 和 完整 的 移动 软件 ,其 由 
包括 中 国 移动 .摩托 罗拉 ,三 星 、 华 为 .英特尔 和 德州 仪器 等 多 家 手机 制造 商 .软件 开发 商 . 电 
信和 运营 商 以 及 芯片 制造 商 组 成 的 全 球 性 联盟 组 织 进行 开发 改良 。 

根据 百度 发 布 的 (移动 互联 网 发 展 趋势 报告 2015 贺岁 版 ) 报 告 ,Android 已 经 成 长 为 
全 球 市 场 占 有 率 最 高 的 移动 互联 网 系统 .市 场 占有 率 高 达 79% 。 国 家 工业 和 信息 化 部 一 
类 科研 事业 单位 中 国电 子 信息 产业 发 展 研究 院 于 2015 年 4 月 21 日 发 布 (移动 互联 网 发 
展 白皮书 (2015 版 )》, 和 白皮书 指出 : 移动 互联 网 流量 成 倍增 长 .2011 年 ,全 球 每 月 移动 互 
联网 流量 约 为 600PB.2014 年 这 一 数字 上 升 至 3200PB; 截 至 2015 年 1 月 .全球 接 入 互联 
网 的 移动 设备 总 数 超过 70 亿 台 ,几乎 平均 全 球 人 手 一 台 ;2014 年 ,我 国 移动 互联 网 市 场 
继续 莲 勃 发展 .总 市 场 规模 突破 千 亿 元 大 关 ;Android 和 iOS 在 电 商 导购 、 生 活 助手 、 视 频 
播放 、 音 乐音 频 、 拍 摄 美化 .通信 社交 、 休 闲 娱乐 .系统 工具 .图 书 阅读 和 手机 游戏 等 移动 应 
用 活跃 度 较 高 ;可 穿戴 设备 应 用 、 智 能 家 居 产 品 体系 实用 环境 化 和 智能 汽车 领域 可 能 成 为 
移动 互联 的 重要 支撑 点 ;2015 年 全 球 移动 互联 网 收入 达到 4000 亿美 元 ( 约 2. 5 万 亿 元 )， 
比 2014 年 增长 约 1000 亿美 元 ;2015 年 .中 国 移动 互联 网 市 场 的 增 速 仍 将 保持 近 77%% 的 
高 速 增长 .总 市 场 规模 达 3776 亿 元 . 较 2014 年 上 升 1600 亿 元 ;移动 互联 网 引领 电子 、 汽 
车 .化工 ,金融 \ 房 地 产 和 医疗 卫生 6 大 产业 融合 .加 速 转型 产业 结构 ,另外 . 云 计算 助 移动 
终端 发 力 及 移动 互联 网 向 物 联网 过 渡 . 智 能 硬件 市 场 将 爆发 。 
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1.2.1 Android 的 优势 
和 封闭 式 的 iOS 相 比 .Android 具有 市 场 占有 率 最 高 .应 用 发 展 迅 速 .众多 智能 厂商 
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大 力 支持 、 价 格 低廉 ,性 能 优越 、 机 型 众多 、 硬 件 配 置 优 .系统 开源 利于 创新 .开发 者 众多 、 
技术 百花 齐 放 等 优势 。 同 时 .Android 平台 支持 Java 和 众多 脚本 语言 作为 应 用 软件 开发 
语言 ,这 意味 着 PC 端 开发 人 员 可 以 不 用 重新 学 习 新 的 开发 语言 ,以 低 成 本 低 风 险 迅速 转 
型 为 Android 开发 人 员 ,为 移动 互联 网 产业 提供 丰富 的 人 力 资源 支持 。 尽 管 Android 也 


面临 着 更 新 速度 快 和 开发 混乱 等 挑战 .但 相信 问 
1.2.2 Android 发 行 版 本 


会 得 到 重视 并 得 到 有 效 解决 。 


Android 1.0 beta 是 Android 最 早 的 版 本 ,其 开始 于 2007 年 11 月 , 记 今 已 经 历 多 个 
新 版 本 的 变更 。 新 版 本 都 会 在 前 一 版 本 的 基础 上 修复 bug 并 新 添 前 一 版 本 没有 的 新 功 
能 。 谷 歌 公 司 通常 以 甜点 名 称 为 不 同 的 Android 版 本 起 代号 .代号 以 首 字母 排序 , 表 1-1 
列 出 了 Android 不 同 版 本 、 代 号 和 API 等 级 。 


Android 版 本 、 代 号 和 API 等 级 







































































Android 版 本 代 号 API 等 级 
Android 1.0 1 
Android Android 1. 1 Petit Four 2 
Android 1.5 Cupcake 5 
Android 1.6 Donut 4 
Android 2.0 Eclair 5 
Android 2.0.1 Eclair 6 
Android 2.1 Eclair 7 
Android 2.2~2.2.3 Froyo 8 
Android 2.3~2.3.2 Gingerbread 9 
Android 2.3. 3 一 2. 3.7 Gingerbread 10 
Android 3.0 Honeycomb 11 
Android 3.1 Honeycomb 12 
Android 3.2 Honeycomb 13 
Android 4.0~4.0.2 Ice Cream Sandwich 14 
Android 4.0.3~4.0.4 Ice Cream Sandwich 15 
Android 4.1 Jelly Bean 16 
Android 4.2 Jelly Bean 17 
Android 4.3 Jelly Bean 18 
Android 4.4 KitKat 19 
Android 4.4W 20 
Android 5.0 Lollipop 21 
Android 5.1 Lollipop 22 
Android 6.0 Marshmallow 23 
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1.3 Andro 辽 系统 架构 


Android 采用 分 层 的 架构 ,其 架构 如 图 1-1 所 示 . 由 应 用 层 、 应 用 框架 层 、 系 统 运行 库 
层 和 Linux 核心 层 构 成 。Android 应 用 层 由 运行 在 Android 设备 上 的 所 有 应 用 共同 构 
成 , 它 不 仅 包 括 通话 、 短 信 、 联 系 人 等 系统 应 用 ( 随 Android 系统 一 起 预 装 在 移动 设备 上 )， 
还 包括 其 他 后 续 安装 到 设备 中 的 第 三 方 应 用 。 应 用 程序 框架 是 Android 应 用 开发 的 基 
础 ,开发 人 员 可 以 直接 使 用 该 层 提供 的 组 件 快速 构建 自己 的 应 用 程序 .但 是 必须 要 遵守 其 
框架 的 开发 原则 。 系 统 运行 库 层 是 由 Linux 提供 的 库 , 这 些 库 通常 由 C 或 C++ 实现 , 具 
有 较 高 的 性 能 ,这 些 库 通常 面向 某 个 应 用 领域 .SQLite( 关 系数 据 库 )、WebKit(Web 浏览 
器 引擎 ) 和 OpenGL-ES( 图 形 库 ) 等 是 常用 的 库 , 应 用 程序 或 框架 可 以 基于 这 些 库 进行 开 
发 ,这 样 做 可 复 用 库 提高 开发 进度 和 具有 较 高 的 稳定 性 等 。 Android 的 核心 系统 服务 由 
Linux 内 核 提 供 , 包 括 安全 性 、 内 存 管理 、 进 程 管 理 , 网 络 协议 栈 和 驱动 模型 等 都 依赖 于 











































































































































































































Linux 内 核 。 
应 用 程序 和 小 部 件 
主 程序 联系 人 浏览 器 小 部 件 用 户 应 用 程序 
应 用 程序 框架 
活动 管理 器 窗口 管理 器 内 容 提供 者 视图 系统 通知 管理 器 
软件 包 管理 器 | | 电话 管理 器 资源 管理 器 位 置 管理 器 传感器 管理 器 
库 Android 运 行 时 
界面 管理 器 媒体 管理 器 SQLite 核心 库 
OpenGL/ES FreeType WebKit Dalvik 虚 拟 机 
SGL SSL libe 
Linux 内 核 
显示 驱动 蓝牙 驱动 相机 驱动 闪存 驱动 IPC 驱 动 
键盘 驱动 USB 驱 动 Wi-Fi 驱 动 音频 驱动 电源 管理 
图 1-1 Android 体系 结构 
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1.4 SL4A 及 脚本 引擎 


1.4.1 SL4A 是 什么 


SL4A 是 Android 应 用 组 件 . 最 初 的 名 字 是 ASE(Android Scripting Environment)， 
它 的 目的 就 是 支持 使 用 简单 的 脚本 语言 来 开发 Android 应 用 程序 .使 Android 开发 简单 
和 快速 。SL4A 最 初 由 谷歌 公司 员工 Damon Kohler 开发 维护 , 现 已 列 入 谷歌 公司 的 开源 
项 目 。SL4A 支持 的 脚本 语言 包括 Python、 Perl、JRuby、Lua、 BeanShell、JavaScript、Tcl 
和 shell 等 。 


1.4.2 SL4A 工作 原理 


SL4A 系统 由 SL4A RPC Server 组 件 和 脚本 引擎 组 成 ,脚本 引擎 负责 脚本 应 用 的 解 
释 运行 ,SL4A RPC Server 组 件 的 作用 是 向 脚本 提供 Android 原生 态 服 务 。SL4A 系统 
工作 原理 基于 JSON-RPC 远程 调用 .脚本 应 用 通过 本 地 的 脚本 引擎 和 远 端 的 SL4A RPC 
Server 组 件 进 行 信 息 交 互 ,以 远程 代理 方式 间接 访问 Android 原生 态 服务 , 先 由 脚本 引擎 
把 本 地 脚本 调用 的 方法 通过 JSON 数据 格式 进行 封装 远程 传递 给 SL4A RPC Server 组 
件 , 然 后 再 由 SL4A RPC Server 组 件 解析 出 JSON 数据 感知 调用 的 方法 ,依次 调用 实际 
的 Android 系统 原生 态 方法 ,再 然后 将 操作 的 执行 结果 以 JSON 数据 格式 返回 给 本 地 脚 
本 引擎 ,最 后 脚本 引擎 把 结果 转发 给 脚本 应 用 进行 处 理 和 显示 结果 。 任 何 本 地 脚本 语言 
引擎 ,只 要 实现 了 这 套 兼容 的 JSON-RPC 通信 接口 ,就 可 以 远程 呼叫 SL4A RPC Server 
组 件 共 享 Android 服务 。 远 程 呼叫 SL4A RPC Server 并 不 是 说 SL4A RPC Server 和 脚 
本 引擎 分 别 运 行 在 不 同 的 Android 设备 端 ,实际 上 ,它们 运行 在 同一 个 Android 设备 端 ， 
只 不 过 它们 是 通过 网 络 协 议 实 现 通信 的 。SL4A 体系 结构 如 图 1-2 所 示 。 以 Python 脚 
本 程序 访问 Android 服务 为 例 . 脚 本 程序 myscript. py 由 Python 脚本 引擎 解释 运行 , 肢 
本 程序 要 访问 Android 系统 服务 , 需 经 脚本 引擎 的 Android RPC Module 模块 向 SL4A 
RPC Server 发 出 Android 服务 请 求 . 请 求 数据 格式 使 用 JSON 数据 格式 ,再 由 SL4A 
RPC Server 调用 Android 原生 态 API 获取 Android 服务 .之 后 再 按 原 路 以 JSON 数据 格 
式 把 Android 服务 结果 返回 给 脚本 程序 。 

Android 脚本 调用 SL4A 服务 的 整个 执行 过 程 如 下 所 示 。 

(1) 启动 脚本 引擎 ; 

(2) 脚本 引擎 解析 运行 脚本 应 用 ; 

(3) 脚本 应 用 调用 一 个 名 为 “脚本 Android RPC 模块 ”的 本 地 代理 ; 

(4)“ 脚 本 Android RPC 模块 ”以 JSON 方式 执行 远程 过 程 调用 (Remote Procedure 
Calls) 向 SL4ARPC Server 请 求 服务 ; 

(5) SL4A RPC Server 的 远程 代理 接受 请 求 ; 

(6) SL4A RPC Server 调用 Java Android API 向 Android 系统 请 求 服务 ; 

(7) Android 系统 提供 最 终 服务 以 JSON 格式 打包 执行 结果 并 按 原 执行 路 径 返 回 给 
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Scripting Layer for Android (SL4A) 
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(Android Java Application) 
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图 1-2 SL4A 体系 结构 


脚本 应 用 。 

每 种 脚本 在 本 地 都 封装 一 个 Android 类 ,由 这 个 Android 类 充当 “脚本 Android RPC 
模块 "角色 ,脚本 应 用 通过 这 个 Android 类 的 实例 实现 RPC 调用 与 SL4A Server 端 通信 。 
下 面 是 由 JavaScript 和 PHP 脚本 编写 的 Android 类 及 其 工作 过 程 的 描述 ,这 两 个 类 文件 
在 脚本 引擎 安装 成 功 后 就 已 经 存储 在 系统 中 了 ,不 需要 开发 人 员 手 工 编写 。 

JavaScript 编写 的 Android 类 


var AP_PORT= java. lang. System. getenv (“AP_PORT”) ; 
var AP_HOST= java. lang. System. getenv (“AP_HOST”) ; 
var AP_HANDSHAKE= java. lang. System. getenv (“AP_HANDSHAKE”) ; 
load( /sdcard/com. googlecode. rhinoforandroid/extras/rhino/json2. js’ ); 
function Android() { 
this. connection= new java. net. Socket (String (AP_HOST), AP_PORT), 
this. input= new java. io. BufferedReader( 
new java. io. InputStreamReader (this. connection. getInputStream(), “8859_1”), 
1<<13), 
this. output=new java. io. PrintWriter (new java. io.0utputStreamWriter( 
new java. io. BufferedOutputStream(this. connection. getOutputStream(), 
1<<13), 
“8859_1”), true), 
this. id=0, 
this. rpc=function (method, args) { 
this. id+=1; 
var request= JSON. stringify ({ id : this. id, ’ method’ : method,’ params’ : args}); 
this. output. write(request+ Nm ); 
this. output. flush(); 
var response= this. input. readLine(); 
return JSON. parse (response); 
入 
this. noSuchMethod =function(id, args) { 


idc 周二 加 局 而 多 起 末 


PHP 编写 的 Android 类 : 
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); 
return ¥ret; 
} 
public function call (¥name, ¥args) 
{ 
return ¥this-> rpc (¥name, ¥args); 
} 
} 


当 JavaScript 脚本 首次 与 SL4A Server 通信 时, 它 会 调用 远程 方法 _authenticate 完 
成 SL4A Server 对 脚本 的 认证 鉴定 。 当 JavaScript 脚本 应 用 通过 Android 类 的 实例 试图 
调用 一 个 不 存在 的 本 地 方法 时 ,就 会 触发 该 实例 的 noSuchMethod 方法 。 当 
_ noSuchMethod ”方法 被 调用 时 ,JavaScript 引擎 会 传 入 两 个 参数 ,一 个 是 被 调用 方法 的 
名 称 , 另 一 个 是 参数 数组 ,这 个 参数 数组 涵盖 传递 给 被 调用 方法 的 所 有 参数 ,如 果 被 调用 
函数 未 传递 参数 ,那么 参数 数组 就 是 空 数 组 。 获 取 被 调用 方法 名 称 和 参数 后 ,在 本 地 方法 
rpc 中 把 方法 和 参数 封装 成 JSON 数据 远程 调用 SL4A Server 的 方法 ,SL4A Server 响应 
并 返回 结果 ,Android 类 实例 会 把 结果 解析 成 JSON 数据 返回 给 脚本 应 用 处 理 。PHP 的 
Android 类 工作 过 程 与 JavaScript 的 Android 类 工作 过 程 相同 。 


1.4.3 脚本 和 脚本 引擎 


脚本 英文 名 为 script' 它 是 批 处 理 文件 的 延伸 。 脚 本 文件 是 按 规定 的 语法 规则 编写 
的 可 执行 文本 文件 。 从 语法 上 看 .脚本 比较 接近 自然 语言 , 比 C、C++ 和 Java 等 编程 语言 
更 简单 ,更 容易 掌握 ;在 执行 方式 上 .脚本 多 为 文本 解释 式 执行 方式 ,其 执行 的 内 容 不 仅 可 
以 被 计算 机 理解 ,还 可 以 被 人 类 所 理解 ,而 C、C++ 和 Java 等 编程 语言 是 二 进 制 编译 式 执 
行 方 式 ,其 执行 内 容 可 被 计算 机 理解 但 不 可 被 人 类 理解 ;在 执行 效率 方面 ,由 于 脚本 应 用 
需要 脚本 引擎 解释 才 可 在 系统 上 执行 .在 执行 时 多 了 一 道 “翻译 ”工序 .而 二 进 制程 序 直 接 
被 系统 执行 ,因此 脚本 的 执行 效率 较 低 。 

脚本 语言 刚 诞生 的 时 候 .其 常见 任务 就 是 把 各 种 不 同 的 已 有 组 件 连 接 起 来 以 完成 相 
关 任 务 .仅仅 被 当 作 批 处 理 和 Shell 脚本 使 用 ,纯粹 是 辅助 工具 。 由 于 处 于 非 主流 地 位 ， 
脚本 语言 的 发 展 是 相当 缓慢 的 。 直 到 20 世纪 90 年 代 初 , 随 着 Python 和 Ruby 等 脚本 的 
陆续 出 现 ,脚本 语言 才 得 到 了 快速 发 展 。 脚 本 语言 通常 都 有 简单 、 易 学 和 易 用 的 特性 , 目 
的 就 是 希望 能 让 程序 员 快 速 完成 程序 的 编写 工作 。 虽 然 现 在 的 许多 脚本 语言 都 超越 了 计 
算 机 简单 任务 自动 化 的 领域 ,成熟 到 可 以 编写 精巧 的 程序 .但 仍然 还 是 被 称 为 脚本 。 几 乎 
所 有 计算 机 系统 的 各 个 层次 都 支持 脚本 语言 :包括 操作 系统 .计算 机 游戏 .文字 处 理 和 网 
络 软件 等 。 

所 谓 脚本 引擎 .就 是 一 个 计算 机 脚本 语言 的 解释 器 . 它 的 功能 是 解释 执行 用 户 编写 的 
脚本 程序 , 它 将 脚本 程序 译 成 计算 机 能 执行 的 机 器 代码 .完成 用 户 指定 的 功能 。 一 种 脚本 
语言 可 以 拥有 多 不 同 的 脚本 引擎 ,各 个 脚本 引擎 在 语言 特性 、 执 行 性 能 和 功能 扩展 等 方面 
会 有 不 同 的 表现 。 以 搜索 引擎 为 例 .用 户 要 了 解 “ 电 视 机 ”相关 的 信息 .可 输入 搜索 关键 字 
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“电视 机 ?并 通过 百度 有 道 和 谷歌 等 众多 搜索 引擎 来 搜索 相关 信息 .这 里 的 “电视 机 ”就 好 
比 脚本 内 容 .搜索 引擎 就 好 比 脚本 引擎 。 


1.4.4 Android 支持 的 脚本 引擎 


开发 人 员 不 仅 可 以 使 用 Java 语言 开发 Android 应 用 ,也 可 以 通过 NDK 使 用 C/C++ 
语言 开发 Android 应 用 程序 .但 Android 应 用 的 开发 语言 并 没有 局 限 在 Java、C 和 C ++ 
编程 语言 。 开 发 人 员 基 于 SL4A 服务 和 脚本 引擎 便 可 使 用 脚本 语言 开发 Android 应 用 ， 
和 SL4A 兼容 的 脚本 引擎 数量 众多 ,其 支持 的 脚本 语言 包括 Python, Perl、JRuby、Lua、 
BeanShell JavaScript Tel shell 和 PHP 等 。 开 发 人 员 可 根据 自身 状态 从 中 选择 适合 的 
脚本 语言 作为 Android 应 用 的 开发 语言 。 

站 点 PHP for Android project(PFA) 声称 项 目 PHP for Android project(PFA) 不 仅 
可 以 让 PHP 开发 在 Android 平台 成 为 可 能 .而 且 还 提供 相应 的 工具 和 文档 支持 PHP 开 
发 。 该 项 目的 主要 赞助 商 是 开源 公司 IronTec, 该 项 目 提供 一 个 Android 应 用 文件 
PhpForAndroid. apk, 通 过 该 APK .PHP 脚本 可 以 被 Android 平台 解析 和 运行 ,并 且 可 以 
借助 SL4A 访问 Android 服务 。 关 于 Android PHP 引擎 ,可 访问 站 点 http://www. 
phpforandroid. net/doku. php 了 解 其 更 详细 的 信息 。 

Python for Android 项 目 提供 了 在 Android 平台 上 对 Python 语言 的 支持 。Python 
是 一 个 功能 强大 的 脚本 语言 ,可 以 编写 简单 的 脚本 应 用 和 复杂 的 多 线程 应 用 。 在 
Android 上 使 用 Python 最 大 的 优势 是 有 机 会 使 用 成 千 上 万 行 已 编写 好 的 代码 ,而 且 这 些 
代码 均 是 免费 的 。 有 关 Python for Android, 可 参看 站 点 http://python-for-android. 
readthedocs. org/en/latest/。 

QPython 是 一 个 运行 在 Android 平台 上 的 脚本 引擎 . 它 支持 Python 脚本 开发 .嵌入 
了 Python 解释 器 、 控 制 台 ,编辑 器 和 SL4A 库 等 。 它 可 以 使 Android 设备 运行 Python 脚 
本 或 项 目 . 是 完全 免费 的 。QPython 内 还 戏 有 AndroidHelper 、Kivy 图 形 库 和 Bottle 等 
重要 框架 。AndroidHelper 是 一 个 可 以 访问 SL4A 服务 的 框架 .Kivy 是 一 个 面向 Python 
语言 的 图 形 库 , 它 拥有 跨 平台 .开源 免费 .GPU 加 速 和 多 点 触 控 等 众多 特点 ;Bottle 是 一 
个 Python Web 框架 .虽然 整个 框架 较 小 .但 却 自 带 了 路 径 映 射 、 模 板 和 简单 数据 库 访 问 
等 Web 框架 组 件 。QPython 的 官网 为 http://qpython. com/。 

JavaScript 是 一 种 常用 的 Web 前 端 应 用 开发 语言 .Rhino 是 一 个 开源 的 、 完 全 用 Java 
编写 的 JavaScript 引擎 . 通 于 Rhino 引擎 可 以 在 Android 平台 上 开发 JavaScript 应 用 。 
Rhino 中 文 名 为 “犀牛 ”. 它 的 名 字 来 源 于 出 版 公司 07 Reilly 关于 JavaScript 著作 的 封面 。 
Rhino 的 历史 可 追溯 到 1997 年 .Javagator 是 Rhino 的 前 身 .虽然 Javagator 未 能 开花 结 
果 . 但 是 Rhino 却 经 住 考 验 存 活 了 下 来 。Rhino 的 特点 : 支持 JavaScript 脚本 ;允许 使 用 
脚本 直接 操作 Java 类 库 ; 提 供 JavaScript Shell 执行 JavaScript 脚本 ;提供 JavaScript 编 
译 器 将 JavaScript 源 程 序 转换 成 Java 类 文件 。 


第 中 1 这 ”IAndroid 列 的 椰 示 


1.5 Andwid 脚本 开发 环境 


要 在 PC 端 Android 模拟 器 上 使 用 脚本 语言 开发 Android 应 用 程序 需要 安装 Java 
JDK、Android SDK、SL4A 和 脚本 引擎 4 类 软件 .JDK 和 Android SDK 需要 安装 在 计算 机 上 ， 
而 SL4A 和 脚本 引擎 需要 安装 在 Android 模拟 器 或 真实 手机 上 。 软 件 的 安装 过 程 : 先 安装 
JDK 到 计算 机 上 ;然后 安装 Android SDK ;接着 在 计算 机 上 创建 和 管理 Android 模拟 器 ;最 后 
在 模拟 器 上 安装 SL4A 和 脚本 引擎 软件 ,启动 脚本 引擎 程序 自动 完成 文件 下 载 任 务 。 


1.5.1 Java JDK 


由 于 Android 开发 工具 和 模拟 器 等 运行 在 Java 环境 , 因此 首先 需要 安装 Java 的 
JDK。Java 最 先 由 Sun 公司 开发 ,但 之 后 被 Oracle 公司 收购 ,并 在 Oracle 网 站 发 布 。 可 
以 从 Oracle 网 站 http://www. oracle. com/technetwork/java/javase/downloads/index. 
html 下 载 并 安装 JDK SE 6. 0 或 更 高 版 本 。 安 装 JDK 之 后 ,在 控制 台 输 入 命令 “java 
version”, 如 果 显示 “1. 6. x” 或 大 于 1.6, 则 说 阴 安 装 成 功 ,其 过 程 如 图 1-3 所 示 。 


t 《build 1.6-8_18-r 


t UM Chuild 11.8-b1i5, mixed mode 





图 1-3 检测 Java 环境 


1.5.2 Android SDK 安装 


Android SDK(Android Software Development Kit) 中 文 名 称 为 Android 软件 开发 工 
有 具 包 。 它 是 一 些 被 软件 工程 师 用 于 为 特定 的 软件 包 、 软 件 框 架 、 硬 件 平台 和 操作 系统 等 建 
立 应 用 软件 的 开发 工具 的 集合 。 在 Android 中 ., 它 为 开发 者 提供 了 库 文件 以 及 其 他 开发 
所 用 到 的 工具 。 可 以 简单 理解 它 是 开发 工具 包 集 合 , 是 开发 过 程 中 所 用 到 的 工具 包 。 
Android SDK 安装 过 程 如 下 。 

(1) 安装 Android SDK 主 安 装 包 。 主 安装 包 的 主要 作用 是 统一 规划 和 管理 版 本 繁 
多 的 Android 平台 平台 工具 和 硬件 系统 映像 文件 等 。 可 以 先 从 谷歌 的 官方 网 站 http:// 


包 。 下 载 后 直接 解压 缩 到 指定 的 文件 夹 即 可 .本 文 解 压缩 到 c:\android-sdk-windows 文 
件 夹 , 解 压 后 文件 夹 结构 如 图 1-4 所 示 。 


Bd add-ons 2013/9/17 19:12 文件 夹 
dB platforms 2013/9/17 19:12 ”文件 夹 
tools 2013/9/17 19:12 。 文件 去 
局 AVD Manager 2013/9/17 19:12 应 用 程序 
山 SDK Manager 2013/9/17 19:12 ”应 用 程序 
目 sDk Readme 2013/9/17 19:12 。 文本 文档 


1-4 Android SDK 目录 结构 
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(2) 安装 Android 平台 。platforms 文件 夹 存放 有 每 个 平台 真正 的 SDK 文件 . 它 根 
据 API Level 划分 SDK 版 本 .每 个 版 本 的 平台 都 包括 模拟 器 皮肤 、 系 统 资源 、 工 程 创 建 默 
认 模 板 和 模拟 器 映像 文件 等 。 从 https://dl-ssl. google. com/android/repository/ 
android-14_r01. zip 下 载 文件 .下 载 后 解压 缩 文 件 android-14_r01. zip, 把 解压 缩 后 的 
android-4. 0. 1 文件 夹 复 制 到 文件 夹 c:\android-sdk-windows\platforms 中 。 

(3) 安装 平台 通用 工具 。platform-tools 文件 夹 下 存 有 adb、aidl 和 dx 等 通用 工具 。 
可 从 官网 下 载 https://dl-ssl. google. com/android/repository/platform-tools _r14- 
windows. zip, 下 载 后 解压 缩 文件 platform-tools_rl4-windows. zip, 把 解压 缩 后 的 
platform-tools 文件 夹 复制 到 c:\android-sdk-windows 文件 夹 中 。 

(4) 安装 应 用 发 布 工 具 。build-tools 文件 夹 下 存放 了 发 布 Android 应 用 程序 相关 的 
类 库 和 工具 。 解 压 后 的 Android SDK 无 此 文件 夹 , 先 手动 在 c:\android-sdk-windows 文 
件 夹 中 建立 build-tools 子 文件 夹 .然后 从 官方 网 站 下 载 https://dl-ssl. google. com/ 
android/repository/build-tools_r17-windows. zip, 下 载 后 解压 缩 文 件 build-tools_r17- 
windows. zip, 最 后 把 解压 缩 后 的 android-4. 2. 2 子 文件 夹 复 制 到 c:\android-sdk- 
windows\build-tools 文件 夹 中 。 

(5) 安装 硬件 系统 映像 文件 。system-images 文件 夹 中 存放 了 不 同 硬件 系统 结构 的 
映像 文件 ,在 android-sdk-windows 文件 夹 里 面 先 新 建 一 个 system-images\android-14 子 
文件 夹 . 再 解压 缩 下 载 的 文件 sysimg_armv7a-14_r01. zip, 最 后 把 解压 缩 后 的 文件 夹 
armeabi-v7a 复制 到 system-images\android-14 文件 夹 内 即 可 。 

(6) 设置 环境 变量 。 解 压缩 上 述 文件 后 .还 需要 修改 环境 变量 Path ,把 Android SDK 
目录 加 进来 。 在 环境 变量 Path 内 容 的 末尾 加 进 如 下 内 容 : 


c:\android- sdk-windows\tools;c:\android- sdk- windows\platform- tools 


同时 ,还 需要 新 建 环 境 变量 ANDROID_SDK_HOME. 其 值 为 : 


c:\android- sdk- windows 


1.5.3 模拟 器 的 创建 和 管理 


Android 模拟 器 是 一 个 可 以 运行 在 PC 上 的 虚拟 设备 .虚拟 设备 模拟 了 很 多 物理 设备 
的 功能 .有 了 虚拟 设备 即使 没有 物理 设备 也 可 以 运行 ,开发 和 测试 Android 应 用 程序 。 
Android 模拟 器 模拟 的 功能 包括 电话 功能 、 短 消息 功能 .GPS 功能 .鼠标 或 键盘 生成 事件 
功能 .调用 其 他 程序 功能 .访问 网 络 功能 .播放 音频 和 视频 功能 、 保 存 和 传输 数据 功能 、 通 
知 用 户 功能 和 泻 染 图 像 功 能 等 。 但 模拟 器 并 不 支持 USB 连接 、 相 机 /视频 捕捉 、 音 频 输入 
(捕捉 )、 扩 展 耳 机 、SD 卡 的 插入 /弹出 和 蓝牙 等 功能 。 

AVD Manager. exe 是 创建 和 管理 Android 模拟 器 的 程序 . 它 存储 在 c:\android-sdk- 
window\ 文 件 夹 下 。 创 建 模 拟 器 时 需要 填写 AVD Name、 Target、SD Card、Device 和 
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Memory Options 等 参数 。 参 数 AVD Name 表示 模拟 器 名 称 , 可 自行 定义 ,参数 Target 
表示 模拟 机 模拟 的 Android 版 本 .参数 SD Card 表示 模拟 器 SD 卡 的 容量 大 小 , 参数 
Device 表示 模拟 器 的 屏幕 设备 .参数 Memory Options 表示 模拟 器 的 内 存 容 量 。 这 里 
AVD Name、Target、 SD Card、 Device 和 Memory Options 等 参数 值 分 别 是 MyG1、 
Android 4.0 - API Level 14.256M.3. 2" QVGA(ADP2)(320 * 480:mdpi) 和 512M。 创 
建 完 Android 模拟 器 后 ,通过 程序 AVD Manager. exe 启动 模拟 器 就 可 以 运行 .测试 和 调 
试 应 用 程序 了 。 


1.5.4 SL4A 与 脚本 引擎 的 安装 


脚本 的 运行 依赖 SL4A 和 脚本 引擎 。SL4A 和 脚本 引擎 程序 的 安装 比较 简单 , 先 按 
正常 方式 安装 完 后 ,再 启动 脚本 引擎 程序 自动 下 载 脚 本 引擎 文件 即 可 。 但 下 载 脚本 引 
人 擎 文件 依赖 谷歌 网 站 ,由 于 谷歌 网 站 在 国内 存在 访问 速度 慢 等 问题 ,因此 下 载 容 易 失 
败 ， 以 离线 重 定向 方式 下 载 脚本 引擎 文件 可 以 解决 这 个 问题 。 离线 安装 脚本 引擎 过 
程 为 : 安装 Web 服务 器 ;部 署 脚本 引擎 下 载 文件 到 Web 服务 器 ;修改 模拟 器 端的 hosts 
文件 重 定 位 域名 ;安装 脚本 引擎 安装 程序 ;启动 脚本 引擎 程序 继续 从 Web 服务 器 完成 
安装 。 表 1-2 和 1-3 列 出 了 在 Android 模拟 器 中 搭建 PHP 和 JavaScript 环境 所 需 的 文 
件 列 表 。 





























表 1-2 PHP 文件 列表 表 1-3 ”JavaScript 文件 列表 
文件 名 称 说 明 文件 名 称 说 明 

php_extras_r3. zip ] Fe ee 

PHP 引擎 下 载 rhino_extras_r3. zip JavaScript 引擎 下 载 
php_r3. z 

文件 rhino_scripts_r2. zip 文件 
php_scripts_r3. zip 

sl4a_r6.apk SL4A 组 件 

sl4a_r6. apk SL4A 组 件 
phploiundtoid lap PHP 引擎 程序 rhino_for_android_rl. apk | JavaScript 引擎 程序 
PHPnow-1. 5. 6. zip PHPNow 套件 PHPnow-1. 5. 6. zip PHPNow 套件 








SL4A 和 脚本 引擎 等 相关 文件 可 从 站 点 http://pan. baidu. com/s/lmgknrja 下 载 。 
使 用 PHPNow 搭建 好 Web 服务 器 后 .把 脚本 引擎 下 载 文件 存储 在 文件 夹 C:\PHPnow- 
1. 5. 6\htdocs\files 中 。 安 装 SL4A 和 脚本 引擎 程序 。 修改 模拟 器 端的 hosts 文件 ,为 
hosts 添加 两 行 数 据 .分 别 是 “10. 0. 2. 2 android-scripting. googlecode. com” 和 “10. 0. 2. 2 
php-for-android. googlecode. com”。 启 动 脚 本 引擎 程序 自动 完成 下 载 。 打 开 SL4A 程 
序 , 如 果 显 示 脚 本 应 用 实例 . 则 表明 脚本 运行 环境 已 搭建 成 功 。 


1.5.5 运行 第 一 个 Android 脚本 程序 


表 1-4 给 出 了 不 同 脚本 的 “HelloPracticalAndroidProjects!” 范 例 . 它 们 的 使 用 过 程 相 
同 . 都 是 先 引 入 Android 包 . 然 后 创建 Android 类 对 象 .最 后 通过 该 对 象 中 的 成 员 方 法 
makeToast 调用 Android 服务 显示 字符 串 “ HelloPracticalAndroidProjects!”。 


WwW | 
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表 1-4 SL4A 脚本 “HelloPracticalAndroidProjects!” 范 例 
脚本 名 称 “HelloPra 示例 





ical AndroidProje: 








source( "/sdcard/com. googlecode. bshforandroid/extras/bsh/android. bsh") ; 
BeanShell droid 一 Android(); 
droid. call("makeToast"." HelloPractical AndroidProjects!"); 





load( "/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js" ); 
JavaScript vardroid 一 newAndroid(); 
droid. makeToast( "HelloPractical AndroidProjects!"); 





packagerequireandroid 
Tal setandroid[androidnew] 


$ androidmakeToast”HelloPracticalAndroidProjects! 





require_once("Android. php"); 
PHP $ droid 一 new Android(); 
$ droid->makeToast("HelloPractical AndroidProjects!"); 





Importandroid 
Python andy 一 android. Android() 
andy. makeToast(" HelloPractical AndroidProjects!") 





droid 一 Android. new 





Rut 
7 droid. makeToast" HelloPractical AndroidProjects!" 
useAndroid; 
Perl my$ a= Android-> 0); 











makeToast("Hello Practical AndroidProjects 


下 面 是 带 有 UI 界面 的 PHP、Python 和 JavaScript 完整 范例 ,范例 的 功能 相同 ,都 是 
先 要 求 用 户 输入 姓名 .然后 再 显示 用 户 姓 名 。 
【 例 1-1】 (范例 1-1 代码 位 置 : \1\uisayHELLO. php) 


< ?php 

require_once(”Android. php”):; 

Ydroid= new Android(); 

¥name=¥ droid- > dialogGetInput ("Hello!”, “What is your name?”); 
¥droid- > makeToast(’Hello, ’ . ¥name[’ result’ ]); 

php?> 


【 例 1-2〗 (范例 1-2 代码 位 置 : \1\uisayHELLO. py) 


import android 

droid= android. Android () 

name= droid. dialogGetInput ("Hello!”, “What is your name?”) 
print name 


droid. makeToast (“Hello, % s” % name.result) 
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【 例 1-3】 (范例 1-3 代码 位 置 : \1\uisayHELLO. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var name= droid. dialogGetInput ("Hello!”, “What is your name?”); 


droid. makeToast ( Hello, ’ +name); 


先 在 控制 台 下 输入 命令 “adb push 脚本 文件 /sdcard/sl4a/scripts/” 把 脚本 文件 下 载 
到 Android 模拟 器 中 .然后 从 模拟 器 中 运行 SL4A 程序 .从 SL4A 显示 的 脚本 列表 中 选 
择 、 单 击 脚 本 文件 图 标 运行 该 脚本 程序 ,运行 结果 Y 
如 图 1-5 所 示 。 [©) Hello! 









1.5.6 脚本 编辑 器 What is your name? 
SL4A 编辑 器 不 仅 可 以 启动 脚本 程序 ,还 可 以 
编写 基本 程序 , 它 的 一 个 重要 特点 是 可 以 在 模拟 [Pu | 


器 上 编写 代码 。 在 室外 从 事 网 络 应 用 测试 等 工作 

时 ,携带 PC 工作 并 不 是 很 方便 ,而 使 用 SL4A 编 Mr 
辑 器 编写 代码 调试 程序 是 比较 好 的 选择 。SL4A 

编辑 器 除了 提供 基本 的 编辑 功能 外 .还 提供 了 API 

浏览 功能 .这 为 开发 或 调试 脚本 应 用 工作 提供 了 便利 。 

在 PC 上 编写 脚本 代码 的 选择 性 较 广 , 本 书 选用 phpDesigner 开发 工具 。 
phpDesigner 是 一 个 功能 强大 ,性 能 超 快 的 PHP 集成 开发 工具 , 它 除 支持 PHP 开发 之 
外 ,还 支持 HTML、CSS、XML、SQL、JavaScript、VBScript、Perl、Python 和 Ruby 等 语言 。 
phpDesigner 内 建 SVN 版 本 管理 .项目 管理 .FTP 传输 文件 .文件 比较 和 中 英文 界面 切换 
等 功能 ,这 些 功能 表明 phpDesigner 不 仅 适合 小 型 应 用 开发 .还 适合 具有 一 定 规模 的 团队 
协作 开发 。phpDesigner 最 新 版 本 是 8. 1. 2, 有 关 phpDesigner, 可 到 官方 站 点 http:// 


www. mpsoftware. dk/phpdesigner. php 查看 。 


图 1-5 脚本 运行 结果 


1.6 ”SL4A AP I 数据 标准 


JSON 的 全 称 是 JavaScript Object Notation, 意 思 是 JavaScript 对 象 表 示 法 . 它 是 一 
种 基于 文本 、 独 立 于 语言 的 轻 量 级 数据 交换 格式 。 和 另 一 个 跨 平台 的 数据 交换 标准 XML 
相 比 ,JSON 具有 数据 量 小 、 理 解 性 好 和 解析 简单 等 优点 。 在 应 用 程序 交换 数据 过 程 中 更 
倾向 于 选择 JSON 来 交换 数据 。 脚 本 与 SL4A 基于 JSON 数据 标准 进行 通信 . 即 脚本 向 
SL4A 请 求 服务 以 及 SL4A 回应 服务 的 数据 格式 都 是 JSON 格式 。 脚 本 向 SL4A 请 求 服 
务 JSON 格式 定义 如 下 : 


{"id”:id 值 , “method”: 方 法 名 称 , “params”: 参 数值 } 
id 值 用 于 标识 通信 会 话 .同一 个 会 话 的 id 值 相同 ,method 是 远程 调用 的 方法 ， 
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params 是 远程 调用 方法 的 参数 .参数 用 JSON 表示 .这 表明 参数 可 以 是 简单 数据 、 数 组 或 
对 象 等 。 例 如 , ("id":1."method":"makeToast","params":" Hello World"} 表 示 调 用 
SL4A 服务 中 的 方法 makeToast, 传 递 给 方法 的 参数 值 是 "Hello World” ,该 方法 的 作用 是 
显示 字符 串 “Hello World”。 

SL4A 响应 脚本 请 求 的 JSON 格式 定义 如 下 : 

{"id”:id 值 , “result”: 调 用 结果 , “error”: 错 误 描述 } 

id 值 用 于 标识 通信 会 话 ,result 描述 SL4A 服务 返回 的 数据 ,如 果 没 有 返回 值 , 则 返 


回 值 为 null, error 描述 错误 信息 ;如 果 远 程 方法 调用 正常 没有 错误 , 则 error 值 为 null。 
比如 ,{"id" :1,"result" :null,"error":null} 表 示 远 程 方法 正常 执行 且 没 有 返回 结果 。 


1.7 Andwid 辅助 开发 工具 


1.7.1 DDMS 


DDMS 的 全 称 是 Dalvik Debug Monitor Service, 中文 名 为 Dalvik 虚拟 机 调试 和 监视 
服务 ,该 应 用 以 图 形 界面 操作 方式 提供 截取 设备 屏幕 ,查看 虚拟 机 调试 信息 、 查 看 LogCat 
事件 日 记 信息 广播 状态 信息 ,模拟 电话 呼叫 、 接 收 SMS 和 虚拟 地 理 坐 标 等 功能 。 可 以 在 
Android SDK 安装 目录 下 的 tools 子 目 录 下 找到 ddms. bat 批 处 理 文件 ,双击 运行 该 批 处 
理 文件 即 运行 DDMS 程序 。 

在 Android 系统 中 ,每 一 个 Android 应 用 都 运行 在 一 个 Dalvik 虚拟 机 实例 里 ,而 每 
一 个 虚拟 机 实例 都 是 一 个 独立 的 进程 空间 ,每 个 进程 都 有 一 个 不 同 的 端口 用 来 监听 这 个 
Dalvik 虚拟 机 的 debugger。DDMS 工作 过 程 为 : 当 DDMS 启动 时 ,会 连接 到 adb 应 
用 ,并 开启 一 个 device 监视 服务 . 当 有 device 连接 到 adb 或 者 与 adb 断 开 时 ,DDMS 都 会 
得 到 通知 ; 加 一旦 一 个 设备 连接 到 adb, DDMS 就 会 为 它 创建 一 个 Dalvik 虚拟 机 监视 服 
务 , 当 移动 设备 上 有 Dalvik 虚拟 机 启动 或 终止 时 (也 可 以 简单 地 理解 为 有 Android 应 用 
启动 或 终止 ).DDMS 就 会 得 到 通知 ; 图 一 旦 一 个 Dalvik 虚拟 机 开始 运行 ,DDMS 就 会 通 
过 adb 获取 Dalvik 虚拟 机 的 PID, 然 后 为 这 个 Dalvik 虚拟 机 设置 一 个 端口 ,监听 来 自 这 
个 Dalvik 虚拟 机 的 debugger, 为 第 一 个 Dalvik 虚拟 机 设置 的 监听 端口 是 8600 ,第 二 个 监 
听 端 口 是 8601 .顺序 依次 增加 端口 号 ; @Dalvik 虚拟 机 的 debugger 抓 取 到 Dalvik 虚拟 
机 的 堆栈 和 线程 等 运行 时 信息 ,通过 连接 到 DDMS 为 这 个 Dalvik 虚拟 机 设置 的 监听 端 
口 ,把 运行 时 信息 发 送 到 DDMS 上 了 。 

版 本 号 为 20 的 DDMS 主 界面 由 设备 视图 (左上 角 窗 口 )、 设 备 状态 视图 (右上 角 窗 
口 )、LogCat 视图 ( 右 下 角 窗 口 ) .Filter 视图 (左下 角 窗 口 ) 和 菜单 组 成 。 设 备 视图 列 出 了 
同 DDMS 连接 上 的 所 有 模拟 器 及 其 所 有 应 用 程序 :开发 人 员 可 以 选择 不 同 的 模拟 器 和 应 
用 进行 监视 。 

设备 状态 视图 列 出 了 某 个 应 用 的 信息 (Info)、 线 程 (Threads)、 虚 拟 机 堆栈 (VM 
Heap) 、 系 统 信息 (Sysinfo)、 网 络 (Network) ,模拟 器 控制 (Emulator Control) 等 卡片。 
Threads 显示 了 开发 人 员 在 Devices 视图 中 选中 的 进程 中 正在 运行 的 线程 信息 .进程 通常 
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包含 主线 程 和 垃圾 收集 线程 等 线程 。VM Heap 可 以 检测 是 否 存在 内 存 泄 漏 。 内 存 泄漏 
是 指 程序 动态 分 配 了 内 存 . 即 使 这 部 分 内 存 使 用 完 后 没有 存在 的 意义 ,程序 也 不 会 释放 这 
部 分 内 存 .导致 系统 运行 变 慢 或 应 用 程序 崩溃 。 内 存 泄漏 检测 过 程 : 启动 某 应 用 不 断 操 作 
该 应 用 ,观察 Heap 视图 的 Total Size 属性 值 .其 值 是 当前 应 用 所 占用 的 内 存 总 量 .如 果 此 值 
在 多 次 GC( 垃 圾 回收 ) 后 没有 明显 回落 .那么 可 以 认为 存在 内 存 泄漏 。Sysinfo 可 以 监视 
CPU 负荷 和 内 存 使 用 等 信息 。Emulator Control 可 以 模拟 电话 , 短 消息 和 GPS 功能 。 

LogCat 视图 可 以 输出 系统 和 应 用 程序 的 日 志 信息 。 每 条 日 志 由 日 记 级 别 (Level)、 
时 间 (Time) .进程 ID(PID) .线程 ID(TID) 应 用 程序 包 名 (Application) ,标签 (Tag) 和 日 
志 正 文 (Text) 组 成 。 日 志 可 划分 为 V(VERBOSE) .DIDEBUG) IINFO)、WCWARN)、 
E(ERROR) 等 级 别 。LogCat 能 根据 级 别 选择 性 输出 日 记 信息 。 等 级 V 是 指 不 过 滤 日 记 
信息 ,输出 V、D、I、W 和 下 等 级 别 的 信息 。 等 级 D 是 指 只 输出 D.I.W 和 下 调试 信息 。 
等 级 I 是 指 只 输出 I.W 和 下 调试 信息 。 等 级 W 是 指 只 输出 W 和 调试 信息 。 等 级 下 
是 指 只 输出 下 调试 信息 。 

Filter 视图 提供 了 日 记 信 息 过 滤器 定义 功能 ,过 滤器 可 以 过 滤 掉 开 发 人 员 不 关心 的 
日 记 信息 或 者 说 只 输出 开发 人 员 关 心 的 日 记 信 息 , 过 滤器 可 以 根据 标签 .PID、 应 用 程序 
包 名 和 日 记 级 别 过 滤 日 记 信息 。 

菜单 项 提供 了 设置 Dalvik 虚拟 机 监听 端口 .触发 垃圾 回收 .文件 传输 、 截 取 模 拟 器 屏 
幕 、 输 出 模拟 器 的 进程 状态 和 输出 模拟 器 的 设备 状态 等 功能 。 


1.7.2 adb 调试 桥 


adb(Android Debug Bridge) 中 文 名 称 作 安 卓 调试 桥 程序 .调试 应 用 程序 是 它 的 一 个 
主要 功能 , 除 此 之 外 .借助 adb 工具 还 可 以 拥有 管理 手机 状态 .安装 软件 .系统 升级 .运行 
shell 命令 上传 下 载 文 件 和 管理 端口 映射 等 功能 。 总 之 ,adb 应 用 是 Android 模拟 器 与 
PC 端的 中 介 , 它 可 以 让 用 户 在 PC 上 以 命令 的 方式 对 模拟 器 进行 全 面 操作 。 图 1-6 是 
adb 应 用 的 体系 结构 图 , 它 是 一 种 基于 C/S 结构 的 体系 , 它 由 Client Server 和 adbd 守护 
进程 三 部 分 组 成 。Client 是 执行 adb 命令 的 终端 , 它 运行 在 PC 端 .可 以 从 控制 台 上 运行 
adb 命令 启动 Client 程序 。adbd 守护 进程 以 后 台 方 式 运行 在 模拟 器 端 , 它 通过 Server 端 
为 Client 端 提 供 服 务 .adb 命令 最 终 由 它 来 执行 。Server 端 运 行 在 PC 上 . 它 介 于 Client 
和 设备 端 adbd 守护 进程 之 间 ,管理 Client 程序 和 模拟 器 端 adbd 守护 进程 的 通信 ,Server 
端 与 adbd 守护 进程 通过 USB 或 TCP 通信 .Server 与 Client 通过 TCP 通信 。 

启动 Client 端 后 ,Client 端 首先 检查 Server 端 是 否 在 运行 .如 果 没 有 则 先 启动 一 个 
Server 端 。Server 端 启动 后 会 绑 定 到 本 地 的 TCP 端口 5037 上 .并 开始 监听 Client 端的 
命令 .所 有 的 Client 端 都 通过 端口 5037 向 Server 端 发 送 命令 。 同 时 .Server 端 还 会 党; 
与 所 有 正在 运行 的 移动 设备 建立 连接 。Server 端 会 扫描 5555 一 5585 范围 内 的 端口 以 此 
确定 模拟 器 是 否 存在 .一旦 发 现 有 模拟 器 的 存在 .就 会 建立 Server 端 到 模拟 器 端的 连接 。 
值得 注意 的 是 ,每 个 Server 端 到 模拟 器 端的 连接 .模拟 器 端 adbd 进程 都 将 分 配 两 个 连续 
的 端口 .一 个 偶数 端口 (如 5554). 另 一 个 是 奇数 端口 (如 5555)。 偶 数 端口 用 于 模拟 器 端 
控制 台 的 连接 :通过 设备 端 控制 台 可 模拟 传感器 .GPS , 短 消 息 . 电 话 来 电 和 端口 映射 等 功 
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能 .用 户 应 用 telnet 命令 通过 偶数 端口 可 以 直接 进入 设备 控制 台 。 奇 数 端 口 用 于 模拟 器 
操作 ,操作 包括 执行 Android 系统 的 shell 等 命令 。 当 Server 端 与 所 有 的 模拟 器 建立 连 
接 之 后 .就 可 以 使 用 adb 命令 来 控制 或 者 访问 设备 了 。 因 为 Server 端 管理 着 模拟 器 连接 
并 且 可 以 接收 到 从 多 个 Client 的 adb 命令 .所 以 可 以 从 任何 一 个 Client 端 控 制 模拟 器 。 
在 此 以 PC 端 执 行 Android 模拟 器 shell 命令 说 明 adb 工作 过 程 ,用 户 先 在 PC 端 启动 adb 
Client 程序 .在 adb Client 程序 中 输入 adb 命令 ;之 后 adb Client 会 扫描 PC 端口 5037, 如 
果 不 存在 则 启动 adb Server 进程 ;如 果 存 在 则 说 明 adb Server 已 启动 .就 把 shell 命令 转 
发 送 给 adb Server 进程 ;adb Server 把 此 命令 转发 给 端口 为 奇数 (如 5555) 的 Android 模 
拟 器 ,模拟 器 中 的 adbd 负责 接收 命令 和 执行 命令 .并 把 命令 结果 按 原 路 返回 给 adb 
Client 程序 。 





PC 端 
adb Server 进 程 ，5037 端 口 


偶数 端口 (如 5554) | 奇数 端口 (如 5559| 


用 于 控制 台 | A 用 于 shell 命 令 
adbd 进 程 ， 两 个 奇偶 端口 
Android 设 备 端 /模拟 器 
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第 即 草 
Android JavaScript 脚本 基础 


2.1 JavaScript 脚 本 编程 基础 


2.1.1 变量 


变量 从 字面 上 看 .就 是 可 变 的 量 ; 从 编程 角度 讲 , 变量 是 用 于 存储 某 种 / 某 些 数值 的 内 
存 空间 。 所 储存 的 值 .可 以 是 数字 、 字 符 或 字符 串 。 如 果 把 酒店 大 厦 看 作 是 计算 机 内 存 ， 
变量 则 是 其 中 的 一 个 房间 ,变量 的 值 就 是 入 住 酒店 的 客人 .不 同时 间 有 不 同 的 人 入 住 
酒店 。 

变量 在 使 用 前 需要 声明 .没有 声明 的 变量 不 能 使 用 .否则 会 出 错 。 其 作用 是 向 系统 申 
请 一 块 内 存 空 间 用 来 存放 数据 。JavaScript 使 用 统一 的 关键 字 var 来 声明 变量 。 例 2-1 
是 变量 声明 实例 。 

【 例 2-1】 (代码 位 置 : \2\2. 1\statement. html) 


《Script type= “text/JavaScript”> 


var txt; // 声 明 一 个 存储 字符 的 变量 , 变量 名 为 txt 
var studentNumber; // 声 明 一 个 存储 数字 的 变量 , 变量 名 为 studentNumber 
</script> 


例 中 声明 了 两 个 变量 .变量 名 分 别 为 txt 和 studentNumber。 变 量 名 是 唯一 标识 变 
量 的 名 称 。 变 量 命 名 规则 : 由 字母 ,数字 或 下 画 线 组 成 . 且 以 字母 开头 ,关键 字 不 能 为 变 
量 名 。 变 量 名 是 严格 区 分 大 小 写 的 .如 Apple 和 apple 是 两 个 不 同 的 变量 。 变 量 声明 后 ， 
需要 为 它 指定 数据 .这 一 过 程 叫 变量 赋值 .赋值 语法 如 下 所 示 。 

变量 = 表达 式 ; 

其 中 .“ 二 ”为 赋值 号 . 它 的 作用 是 把 右边 的 值 赋 给 左边 的 变量 。 例 2-2 是 变量 赋值 范 
例 .在 声明 变量 的 同时 为 变量 赋值 。 

【 例 2-2】 (代码 位 置 : \2\2. 1\assignment. html) 

《Script type= “text/JavaScript”> 

var txt= Hello world”; // 为 变量 txt 赋 一 字符 串 Hello world 


var studentNumber= 34; // 为 变量 studentNumber 赋 一 整数 34 
《/Script> 
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使 用 浏览 器 方法 alert 可 以 查看 到 变量 中 的 值 , 例 2-3 是 输出 变量 值 的 实例 。 
【 例 2-3】 (代码 位 置 ; \2\2. 1\output_variable. html) 
《Script type= “text/JavaScript”> 

var txt= “Hello world”; 


alert (txt); // 警 告 框 方式 显示 字符 串 “Hello world” 
< /script> 


2.1.2 数据 类 型 


JavaScript 数据 类 型 就 是 变量 值 的 种 类 。JavaScript 变量 包括 基本 数据 类 型 一 一 数 
字 型 , 浮 点 型 ,布尔 型 和 字符 串 型 .复合 数据 类 型 一 一 对 象 和 数组 ,特殊 数据 类 型 一 一 空 类 
型 ,分 别 对 应 不 同 大 小 的 内 存 空间 .数据 类 型 如 表 2-1 所 示 。 





表 2-1 数据 类 型 
基本 类 型 复合 类 型 特殊 类 型 
数字 型 (Number) 数组 (Array) 空 类 型 (Null) 
布尔 型 (Boolean) 对 象 (Function) 未 定义 类 型 (Undefined) 


字符 串 型 (String) 





1. 数字 类 型 


JavaScript 数字 类 型 可 分 为 整数 型 和 浮 点 型 。 整 数 型 可 表示 一 2 147 483 648 一 
十 2 147 483 647 之 间 的 整数 ,可 以 使 用 十 进 制 . 八 进 制 和 十 六 进 制 表示 。 以 0 开头 的 数字 
且 每 个 位 数 的 值 为 0 一 7 的 整数 是 八进制 ;以 0x 开头 .位 数值 为 0 一 9 和 A 一 F 的 数字 是 
十 六 进 制 。 例 2-4 是 整数 型 范例 。 

【 例 2-4】 (代码 位 置 ; \2\2. 1\numerical_data. html) 


《Script type= “text/JavaScript”> 


var NumberInt= 1000; // 十 进 制 数 正 数 

var NumberInt_f=~ 200; // 十 进 制 负数 

var NumberOctal= 0123; // 八 进 制 数 ,等 于 十 进 制 数 83 
var NumberHex= OX1A; // 十 六 进 制 数 ,等 于 十 进 制 数 26 


alert (“十 进 制 整 型 数值 1000 输出 结果 :“+NumberInt ); 

alert (“十 进 制 负数 值 - 200 输出 结果 : “+NumberInt_f ); 

alert (“八进制 负数 值 0123 输出 结果 : “+Number0ctal ); 

alert (“十 六 进 制 负数 值 0xlA 输出 结果 : “+ NumberHex ) ; 
</script> 


此 例会 输出 十 进 制 数 1000、 一 200、83 和 26. 因 为 对 于 八进制 和 十 六 进 制 的 数值 数 
据 ,在 网 页 上 都 是 以 十 进 制 数 据 的 形式 输出 。 

浮 点 型 是 指 包含 小 数 点 的 实数 .可 用 科学 记 数 法 来 表示 . 其 最 大 数 的 绝对 值 为 
1.797 693 134 862 315 7E308, 其 最 小 数 的 绝对 值 是 5E-324, 使 用 e 或 下 符号 代表 以 
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10 为 底 的 指数 ,下 面 是 浮 点 类 型 的 范例 .范例 会 输出 1.234、1200 和 7e-10。 
【 例 2-5】 (代码 位 置 ; \2\2. 1\floating_point. html) 


<script type= “text/JavaScript”> 


var NumberFloat_a= 1.234; // 浮 点 数 
var NumberFloat_b=1. 2e3; 
var NumberFloat_c=7E- 10; // 科 学 表示 法 


alert (“1.234 输出 结果 : “+ NumberFloat_a ); 

alert ("1.2e3 输出 结果 :“+NumberFloat_b ); 

alert (“科学 表示 7E- 10 输出 结果 : “+ NumberFloat_c); 
/script> 


2. 字符 串 类 型 


字符 串 可 以 包含 0 个 或 多 个 Unicode 字符 ,其 中 包含 文字 、 数 字 和 标点 符号 。 字 符 串 
数据 类 型 是 用 来 保存 文字 内 容 的 变量 .JavaScript 程序 代码 的 字符 串 需 要 使 用 单 引 号 或 
双 引 号 括 起 来 。 下 面 是 描述 字符 串 型 的 范例 。 

【 例 2-6】 (代码 位 置 ; \2\2. 1\character_string. html) 


《Script type= “text/JavaScript”> 
var StringTom= “Tom”; 
var StringC= "我 爱 中 国 “; 
alert(“ 输 出 字符 串 StringTom 的 值 :“+ StringTom ) ; 
alert(“ 输 出 字符 串 StringC 的 值 :“+ StringC) ; 
</script> 


范例 运行 的 结果 如 下 所 示 。 


输出 字符 串 StringTom 的 值 : Tom 

输出 字符 串 StringC 的 值 : 我 爱 中 国 

由 于 一 些 字符 在 屏幕 上 不 能 显示 ,或 者 在 JavaScript 语法 上 已 经 有 了 特殊 用 途 , 所 以 
在 字符 串 中 用 这 些 字符 时 .就 要 使 用 “ 转 义 字符 "来 表示 此 类 字符 。 转 义 字 符 以 斜 杠 “\" 起 
头 : 如 \ 表 示 单 引号 、\ "表示 双 引 号 、\n 表示 换行 符 ,\r 表示 回 车 。 

3. 布尔 类 型 

布尔 数据 类 型 只 有 两 个 值 true 和 false. 主要 用 在 条 件 和 循环 控制 的 判断 ,以便 决 定 
继续 运行 对 应 段 的 程序 代码 .或 判断 循环 是 否 结束 。 下 面 是 描述 布尔 型 的 范例 .此 例会 输 
出 布尔 变量 BooleanA 和 BooleanB 的 值 ,分 别 为 true 和 false。 

【 例 2-7】 (代码 位 置 : \2\2. 1\boolean_type. html) 

《script type= “text/JavaScript”> 

var BooleanA= true; // 定 义 布尔 类 型 的 变量 BooleanA, 赋值 为 true 


var BooleanB= false; // 定 义 布尔 类 型 的 变量 BooleanB, 赋值 为 false 
alert (“输出 BooleanA 结果 :“+BooleanA); 
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alert (“输出 BooleanB 结果 : “+ BooleanB); 

《</script> 

4. 空 类 型 

空 数据 类 型 只 有 一 个 null 值 .null 是 一 个 关键 字 . 并 不 是 0。 如 果 变 量 值 为 null, 表 
示 变 量 没有 值 或 不 是 一 个 对 象 。 

5. 未 定义 类 型 

未 定义 数据 类 型 指 的 是 一 个 变量 有 声明 ,但 是 不 曾 指定 变量 值 。 下 例 StudentNumber 
变量 的 值 为 undefined。 


< script type= “text/JavaScript”> 

var StudentNumber; 
alert (StudentNumber) ; // 输 出 undefined 
《</script> 


2.1.3 运算 符 和 表达 式 


表达 式 是 指 具 用 运算 符 把 常数 和 变量 连接 起 来 的 代数 式 . 代 数 式 最 终 会 生成 新 值 。 
运算 符 可 划分 为 赋值 关系、 位 、 逻 辑 和 数学 等 运算 符 。 当 表达 式 中 有 多 个 运算 符 时 ,运算 
符 之 间 有 优先 级 之 分 , 表 2-2 按 从 高 到 低 优先 级 次 序列 出 了 运算 符 。 


表 2-2 运算 符 优先 级 别 






































优先 级 运 算 符 说 明 
1 括号 (x) [x] 中 括号 只 用 于 指明 数组 的 下 标 
—x 返回 x 的 相反 数 
求 反 !x 返回 与 x( 布 尔 值 ) 相 反 的 布尔 值 
自 加 区 二 十 x 值 加 1. 但 仍 返 回 原来 的 x 值 
自 减 x 一 一 x 值 减 1. 但 仍 返 回 原来 的 x 值 
4 x 值 加 1, 返回 后 来 的 x 值 
= 全 x 值 减 1, 返 回 后 来 的 x 值 
xxy 返回 x 乘 以 y 的 值 
3 乘 . 除 x/y 返回 x 除 以 y 的 值 
x%y 返回 x 与 y 的 模 (x 除 以 y 的 余数 ) 
4 加 , 减 后 
i 返回 x 减 y 的 值 
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优先 级 运 算 符 说 明 
wy 
5 按 位 移 x>y 
x 和 >y 
6 | 关系 运算 。 | “| 当 符合 条 件 时 返回 true 值 ,否则 返回 false 值 
x——y 当 x 等 于 y 时 返回 true 值 , 否 则 返回 false 值 
7 | 等 于 .不 等 于 
xl=y 当 x 不 等 于 y 时 返回 true 值 .否则 返回 false 值 
a i 当 两 个 数位 同时 为 时 ,返回 的 数据 的 当前 数位 为 1， 
其 他 情况 都 为 0 
9 | 位 蜡 或 xy 两 个 数位 中 有 且 只 有 一 个 为 0 时 ,返回 0, 香 则 返回 1 
ee 两 个 数位 中 内 要 有 一 个 为 1, 则 返回 1; 当 两 个 数位 都 
为 0 时 才 返 回 0 
1. 赋值 运算 符 
JavaScript 脚本 语言 的 赋值 运算 符 包含 "二 ”十 二 ”一 二 ”二 ”/ 二 ”、*% 二 ” 
“& 一 ”一 "等 ,汇总 如 表 2-3 所 示 。 
表 2-3 赋值 运算 符 
运算 符 | 例子 | 等 价 于 说 明 
x—y 将 运算 符 右 边 变量 的 值 赋 给 左边 变量 
+ 一 x 十 一 y | x 一 x 十 y | 将 运算 符 两 侧 变量 的 值 相 加 并 将 结果 赋 给 左边 变量 
-= x 一 一 y | x 一 x 一 y | 将 运算 符 两 侧 变量 的 值 相 减 并 将 结果 赋 给 左边 变量 
*— xx 一 y | x 一 xxy | 将 运算 符 两 侧 变量 的 值 相 乘 并 将 结果 赋 给 左边 变量 
大 x/=y | x 一 x/y “| 将 运算 符 两 侧 变量 的 值 相 除 并 将 整除 的 结果 赋 给 左边 变量 
%— x% 一 y | x 一 x%y | 将 运算 符 两 侧 变量 的 值 相 除 并 将 余数 赋 给 左边 变量 











下 面 是 描述 赋值 运算 符 的 范例 ,实例 最 终 会 输出 一 2。 
【 例 2-8】 (代码 位 置 : \2\2. 1\assignment_operators. html) 


< script language= “JavaScript” type= ”text/javascript”> 


var msg= 10; 
msg+=8; 
msg —= 100; 
msg *=2; 
msg /=4; 
msg% =3; 
alert (msg) ; 


// 赋 初 值 


//msg=msg+ 8= 18 
//msg=msg- 100= 18- 100=- 82 
//msg=msg* 2=— 82* 2=—164 
//msg=msg/3=—164/4=—41 
//msg=msg% 3=—41% 3=-2 
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</script> 


2. 算术 运算 符 
JavaScript 脚本 语言 中 基本 的 数学 运算 包括 加 、 减 、 乘 \ 除 以 及 取 余 等 ,其 对 应 的 数学 
运算 符 分 别 为 “十 “一 ”x*”*“/” 和 “%” 等 ,如 表 2-4 所 示 。 
表 2-4 算术 运算 符 
运算 符 描 述 例 子 说 明 














+ 加 x 一 y 十 2 | 将 两 个 数据 相 加 ,并 将 结果 返回 操作 符 左 侧 的 变量 

减 x 一 y 一 2 | 将 两 个 数据 相 减 ,并 将 结果 返回 操作 符 左 侧 的 变量 
* 乘 x 一 y*2 | 将 两 个 数据 相 乘 ,并 将 结果 返回 操作 符 左 侧 的 变量 
/ 除 x 一 y/2 | 将 两 个 数据 相 除 ,并 将 结果 返回 操作 符 左 侧 的 变量 














% 求 余数 (保留 整数 ) | x 一 y%2 | 求 两 个 数据 相 除 的 余数 ,并 将 结果 返回 操作 符 左 侧 的 变量 


下 面 是 描述 算术 运算 符 的 范例 ,范例 最 终 会 输出 10、 一 2. 5.3 和 7。 需要 注意 ,字符 
串 和 数值 之 间 的 “十 "符号 是 字符 串 连 接 符 .而 不 是 数学 运算 符 。 
【 例 2-9】 (代码 位 置 ; \2\2. 1\arithmetic_operator. html) 
《Script type= “text/JavaScript”> 
alert(“5x 2= “+5x 2); // 此 处 "+ 是 字符 串 连 接 运 算 符 , 把 其 左右 两 边 的 串 连 成 一 个 串 
alert (“- 5/2.0= "+ 一 5/2.0) ; 
alert(“5-2= “+ (5- 2) ) ; 
// 首 个 "+ "是 字符 ,第 二 个 “+ "是 字符 串 连接 运算 符 , 第 三 个 "+ "是 数学 运算 符 
alert(“5+2= “+ (5+2) ) ; 
</script> 


3. 比较 运算 符 


用 于 比较 两 个 数据 的 运算 符 称 为 比较 运算 符 .比较 运算 符 最 终 会 生成 布尔 值 .比较 运 
算 符 包括 “二 二 ”1 二 ”二 ”二 ”一 一 ”一 一 "等 ,其 具体 作用 见 表 2-5。 


表 2-5 比较 运算 符 











运算 符 | 描 述 例 子 说 明 
Ss 大 于 》 若 左边 数据 大 于 右边 数据 . 则 返回 布尔 值 true, 否则 返回 false 
二 小 于 x<y 若 左边 数据 小 于 右边 数据 , 则 返回 布尔 值 true, 和 否则 返回 false 





二 一 | 大 于 等 于 | x 二 一 y | 若 左边 数据 大 于 或 等 于 右边 数据 . 则 返回 布尔 值 true, 否 则 返回 false 
二 一 | 小 于 等 于 | x 二 一 y | 若 左边 数据 小 于 或 等 于 右边 数据 , 则 返回 布尔 值 true, 否 则 返回 false 























三 三 镍 淤 玫 若 两 数据 相等 . 则 返回 布尔 值 true. 否 则 返回 false 
! 一 “| 不 等 于 车 两 数据 不 相等 . 则 返回 布尔 值 true, 否则 返回 false 
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例 2-10 是 描述 比较 运算 符 的 范例 。 
【 例 2-10】 (代码 位 置 : \2\2. 1\comparison_operator. html) 


<script language=“JavaScript” type= “text/javascript”> 
var myAge=prompt (“请 输入 您 的 年 龄 (数值 ) :“, 25) ; 
var msg=“\n 年 龄 测试 : \n\n”; 
msg+= “年龄 :“+myAge+” 岁 \n”; 
if (myAge< 18) 
msg+= “结果 : 您 处 于 青少年 时 期 ! \n”; 
if (myAge>= 18&&myAge< 30) 
msg+= 结果 : 您 处 于 青年 时 期 ! \n”; 
if (myAge>=30&&myAge< 55) 
msg+= 结果 : 您 处 于 中 年 时 期 ! \n”; 
if (myAge> =55) 
msg+=“ 结 果 : 您 处 于 老年 时 期 ! \n”; 
alert (msg) ; 
</script> 


范例 会 显示 输入 框 请 求 用 户 输入 年 龄 .根据 用 户 输入 的 年 龄 给 出 相应 的 提示 。 如 果 
输入 0 一 17 则 显示 “结果 : 您 处 于 青少年 时 期 !” ;如果 输 入 18 一 29, 则 显示 “结果 : 您 处 于 
青年 时 期 1"; 如 果 输 入 30 一 54 则 显示 “结果 : 您 处 于 中 年 时 期 !1"; 如 果 输 入 大 于 等 于 55 
的 数值 . 则 显示 “结果 : 您 处 于 老年 时 期 ! ”。 

4. 逻辑 运算 符 

逻辑 运算 符 包括 "&.&.”“||" 和 “1!” 等 .用 于 两 个 逻辑 型 数据 之 间 的 操作 .返回 值 的 数 
据 类 型 为 布尔 型 。 逻 辑 运算 符 的 功能 如 表 2-6 所 示 。 

表 2-6 ”逻辑 运算 符 
运算 符 | 描述 例 子 说 明 
&&8。 | 逻辑 与 | x 二 38-&y> 





如 果 符 号 两 边 的 操作 数 为 真 , 则 返回 true, 否 则 返回 false 





ll 逻辑 或 | x 一 8||y 二 4 如 果 符号 两 边 的 操作 数 为 假 , 则 返回 false, 否 则 返回 true 














! “| 过 辑 非 | !x<5 逻辑 非 ,如 果 符 号 右边 的 操作 数 为 真 , 则 返回 false, 否 则 返回 true 
5. 条 件 运 算 符 


条 件 运算 符 “?:" 用 于 创建 条 件 分 支 .其 语法 结构 如 下 : 
(condition)? statementA:statementB; 


其 执行 时 首先 判断 条 件 condition . 若 结果 为 真 则 执行 语句 statementA. 否 则 执行 语 
名 statementB 。statementA 和 statementB 语句 均 必 须 为 单条 语句 . 若 使 用 多 条 语句 会 
报错 。 下 面 是 描述 比较 运算 符 的 范例 :范例 会 要 求 用 户 输入 成 绩 . 如 果 小 于 60 则 提示 “ 系 
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统 提示 : 对 不 起 ,不 及 格 !”; 如 果 大 于 等 于 60 则 提示 “系统 提示 : 及 格 !”。 
【 例 2-11】 〈 代 码 位 置 :\2\2. 1\conditional_operator. html) 


< script type= "text/JavaScript “> 
var score=prompt ("请 输入 您 的 成 绩 :“, 43) ; 
var contentA= “系统 提示 : 对 不 起 , 不 及 格 !”; 
var contentB= “系统 提示 : 及 格 !” 
var msg= (score< 60)?contentA:contentB; 
alert (msg) ; 


《/script> 


6. 位 逻辑 运算 符 


基本 位 运算 符 包 括 "&”|”"*^* 和 “一 "等 ,执行 位 运算 时 先 将 操作 数 转换 为 二 进 制 数 ， 
再 按 位 进行 与 或. 非 和 取 反 等 操作 ,操作 完成 后 将 返回 值 转换 为 十 进 制 。 位 运算 符 的 作 
用 如 表 2-7 所 示 。 




















表 2-7 位 运算 符 
运算 符 描 述 例子 说 明 
BE- 按 位 与 9&6 车 两 数据 对 应 位 都 是 1, 则 该 位 为 1, 否 则 为 0 
机 按 位 异 或 9^6 若 两 数据 对 应 位 相反 , 则 该 位 为 1 ,否则 为 0 
按 位 或 916 车 两 数据 对 应 位 都 是 0, 则 该 位 为 0, 否 则 为 1 
RE 按 位 非 一 4 若 数据 对 应 位 为 0, 则 该 位 为 1, 否 则 为 0 





下 面 是 描述 位 运算 符 的 范例 ,范例 按 位 对 39 和 199 进行 与 和 或 操作 并 输出 7 
和 231。 
【 例 2-12】 (代码 位 置 : \2\2. 1\bitwise_operators. html) 


《script language= “JavaScript” type= “text/javascript”> 
var a= 39; 
var b= 199; 
var c= a&b; //39&199= ( 100111& 11000111 ) 2= ( 111 ) 2=7 
alert(c) ; 
c=alb; //39|199= ( 100111| 11000111)2= ( 11100111 ) 2= 231 
alert(c) ; 

</script> 


7. 位 移 运算 符 


位 移 运算 符 用 于 将 目标 数据 往 指定 方向 移动 指定 的 位 数 。JavaScript 脚本 语言 支持 
“二 二 人 全 二 ”和 "二 二 二 ”等 位 移 运算 符 , 其 具体 作用 见 表 2-8。 
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表 2-8 位 移 运算 符 


























运算 符 | 描述 | 例子 说 明 
ee 将 左 便 数 据 的 二 进 制 值 向 左 移动 由 右 便 数 值 表示 的 位 数 , 右 
| -汪汪 和 必 边 空位 补 0 
ee 将 左 便 数 据 的 二 进 制 值 向 移动 由 右 便 数 值 表示 的 位 数 , 忽 
Bs 略 被 移出 的 位 

Be /| 将 左边 数据 表示 的 二 进 制 值 向 右 移动 由 右边 数值 表示 的 位 
一 一? | 数 ,忽略 被 移出 的 位 , 左 侧 空 位 补 0 





下 面 是 描述 位 运算 符 的 范例 ,范例 对 39 右 移 两 位 ,对 199 左 移 两 位 .并 输出 9 
和 796。 
【 例 2-13】 (代码 位 置 : \2\2. 1\shift_operator. html) 


< script language= “JavaScript” type= “text/javascript”> 
var a= 39; 
var b= 199; 
Var c=a>>2; //39>>2= ( 100111 )>>2= ( 1001 )=9 
alert(c) ; 
c=b<<2; //199<<2= ( 11000111 )<<2= ( 110011100 )= 796 
alert (c); 
</script> 


8. 自 加 和 自 减 运算 符 
自 加 运算 符 为 “十 十 "和 自 减 运算 符 为 ”分 别 将 操作 数 加 1 或 减 1。 值 得 注意 的 
是 , 自 加 和 自 减 运 算 符 放 置 在 操作 数 的 前 面 和 后 面 含义 不 同 。 运 算 符 写 在 变量 名 前 面 . 则 
返回 值 为 自 加 或 自 减 前 的 值 ; 而 写 在 后 面 . 则 返回 值 为 自 加 或 自 减 后 的 值 。 自 加 自 减 运算 
符 的 功能 如 表 2-9 所 示 。 
表 2-9 自 加 自 减 运算 符 


























运算 符 描述 例 子 说 明 

i 十 十 后 加 x 一 i 十 十 ,给 出 结果 i 自 加 了 1 后 再 取 i 的 值 
十 十 i 前 加 y 一 十 十 i 先 取 i 的 值 后 ,i 再 自 加 1 
一 后 减 x 二 i 一 一 i 自 减 了 1 后 再 取 i 的 值 
= 前 减 先 取 i 的 值 后 ,i 再 自 减 1 
下 面 是 描述 自 加 自 减 运算 符 的 范例 。 


【 例 2-14】 (代码 位 置 : \2\2. 1\plus_operator. html) 


< script language= ”JavaScript” type= “text/javascript”> 
var a= 39; 


Var c=++a; // 先 a=at+1, 再 c=a 
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alert(’c: “+c+” a:”+a); // 输 出 “c:40 a:40” 
Var c=at+; // 先 c=a, 再 a=at+1 
alert(“c: +c+” a:”+a); // 输 出 “c:40 a:41” 
var c= 一 一 ai; // 先 a=a-1, 再 c=a 
alert(’c: “+c+” a:”+a); // 输 出 “c:40 a:40” 
var c=a-—; // 先 c=a, 再 a=a-1 
alert(’c: “+ct” a:”+a); // 输 出 “c:40 a:39” 
《</script> 


2.2 ”JavaScript 控制 语句 


语句 是 程序 最 小 的 执行 单位 ,“; "是 单条 语句 的 结束 符号 。 用 大 括号 把 多 条 语句 括 起 
来 ,大 括号 作为 语句 块 的 起 始 符 , 这 些 语句 称 为 复合 语句 ,或 称 为 语句 块 。 复 合 语句 块 的 
语法 如 下 所 示 。 


{ 



































语句 1; 开始 
语句"; 语句 1 
; 1 
复合 语句 经 常 出 现在 选择 和 循环 控制 语句 中 .用 于 完成 复杂 的 编 语句 2 
程 需求 。 按 照 语句 的 执行 顺序 ,可 将 JavaScript 程序 划分 为 三 种 控制 1 
结构 : 顺序 结构 、 选 择 结构 和 循环 结构 。 顺 序 结 构 是 指 程序 从 第 一 行 语句 
语句 开始 ,按照 顺序 逐 行 向 下 执行 .直至 最 后 一 句 . 是 JavaScript 程序 1 
中 最 基本 的 结构 .其 语句 执行 过 程 如 图 2-1 所 示 。 结束 





在 选择 结构 中 .程序 根据 判断 条 件 是 否 成 立 ,选择 执行 不 同 的 语 图 2-1 顺序 结构 
句 。 循 环 结构 中 ,程序 根据 判断 条 件 和 指定 次 数 .使 语句 执行 多 次 。 
JavaScript 提供 控制 语句 选择 和 循环 执行 语句 或 语句 块 .控制 语句 如 表 2-10 所 示 。 
表 2-10 ”控制 语句 





选择 语句 循环 语句 辅助 控制 语句 
if/if**else for break 
switch while continue 
do… while 





2.2.1 条 件 语句 


选择 语句 会 按照 给 定 的 条 件 选择 性 地 执行 一 条 分 支 语句 或 语句 块 .根据 能 选择 的 分 
支 语 句 数量 可 以 分 为 单 向 选择 、 双 向 选择 和 多 向 选择 语句 。 但 无 论 是 单 向 还 是 多 向 选择 ， 
程序 在 执行 过 程 中 都 只 能 执行 其 中 一 条 分 支 。if 是 单 向 选择 语句 .if…else 是 双向 选择 语 
名 .if…elseif 和 switch 是 多 向 选择 语句 。 
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1. if 语 句 

这 语法 结构 如 下 所 示 。 

if (表达 式 ) 

{ 

语句 块 

} 语句 块 

小 括号 中 的 “表达 式 " 通 常 由 比较 运算 符 或 逻辑 运算 符 组 | 
成 ,最 终 运算 结果 是 布尔 值 .是 执行 语句 块 的 条 件 .如 果 表 达 式 结束 





为 true 值 则 选择 执行 花 括号 内 的 语句 块 ,为 false 值 则 跳出 语句 图 2-2 让 语 句 流程 
块 往 下 执行 ,执行 过 程 如 图 2-2 所 示 。 

下 面 是 if 语句 范例 , 例 中 要 求 用 户 输入 考试 成 绩 , 如 果 成 绩 小 于 60 分 则 提示 “成 绩 不 
合格 ,需要 补考 。”。 

【 例 2-15〗 《代码 位 置 : \2\2. 2\if_statement. html) 


<script language= “JavaScript” type= “text/javascript”> 
var score=prompt (“请 输入 您 的 成 绩 :“, 45) ; 
if (score< 60) 
{ 
alert (“成 绩 不 合格 ,需要 补考 .”); 
} 
/script> 


2. if…eke 语 句 
If…else 语法 如 下 所 示 。 


















































开始 if (表达 式 ) 
t fal { 
> 语句 块 1; 
} 
语句 块 | 语句 块 2 a 
Le { 
语句 块 2; 
结束 
国 230 st 作 句 放任 如 果 表达 式 值 为 true 就 选择 执行 语句 块 1, 否 


则 选择 执行 语句 块 2, 执 行 过 程 如 图 2-3 所 示 。 
下 面 是 if…else 语句 范例 . 例 中 要 求 用 户 输 入 成 绩 . 当 成 绩 小 于 60 分 时 提示 “成 绩 不 
合格 ,需要 补考 .”. 否 则 显示 “ 茶 喜 你 .及 格 了 .”。 
【 例 2-16】 《代码 位 置 ; \2\2. 2\if_else_statement. html) 


《script language= ”JavaScript” type= “text/javascript”> 
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var score=prompt ("请 输入 您 的 成 绩 :“, 85) ; // 定 义学 生 课 程 成 绩 为 85 分 
if (score< 60) 
{ 
alert (“成 绩 不 合格 ,需要 补考 .”); 
Y 
else 
{ 
alert( “恭喜 你 ,及 格 了 。) ; 
} 
/script> 


3. 9 jh 语句 
switch 语句 语法 如 下 所 示 。 
switch (表达 式 ) 
{ 
case 入 口 值 1: 
语句 块 1; 
break 
case 入 口 值 2: 
语句 块 2; 


break; 


case 入 口 值 n: 
语句 块 n; 
break 
default: 
默认 语句 块 ; 
} 
表达 式 值 通常 为 整数 和 字符 串 ,而 不 是 布尔 值 。 每 个 case 和 break 之 间 的 语句 称 为 
分 支 语 句 , 可 以 存在 多 个 分 支 语 句 .每 个 分 支 有 一 个 入 口 值 .入口 值 和 表达 式 值 的 数据 类 
型 要 相同 ,入 口 值 用 于 标识 不 同 的 分 支 。 工 作 原理 : 先 计 算出 表达 式 值 ;然后 表达 式 值 会 
与 case 处 的 入 口 值 相 比较 .如 果 与 某 个 case 相 匹 配 .就 执行 相对 应 的 分 支 语 句 块 ,直到 遇 
到 break 语句 才 跳 出 switch 语句 ;如 果 所 有 case 的 入 口 值 与 表达 式 值 不 匹配 , 则 执行 
default 处 的 默认 语句 块 。 执 行 过 程 如 图 2-4 所 示 。 
下 面 是 switch 范例 ,. 例 中 先 要 求 用 户 输入 成 绩 .再 判断 学 生成 绩 等 级 , 例 中 函数 
Math. floor 为 向 下 取 整 函数 .如 85/10, 取 整 结果 为 8。 
【 例 2-17】 〈 代 码 位 置 : \2\2. 2\BranchStatementSwitch. html) 
< script language= JavaScript”type= "text/javascript “> 
var score=prompt (“请 输入 您 的 成 绩 :“, 85) ; 


var grade=Math. floor( score/10 ) ; 
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switch (grade) 
{ 
case 9: 
alert (“优秀 !”); 
break; 
case 8: 
alert(“ 良 好”); 
break; 
case7: 
alert(“ 中 等 ); 
break; 
case 6: 
alert (“及格”); 
break; 
default: 
alert (“不 及 格 ,需要 补考 !”); 
} 
</script> 




















| El 


语句 块 1 | | 语句 块 2 ] | 语句 块 n ][ 语句 块 


1 


| dufault 
































结束 





2-4 switch 语句 


2.2.2 循环 语句 

在 编写 代码 时 .常常 希望 反复 执行 同一 段 代码 。 可 以 使 用 循环 语句 来 完成 这 个 功能 ， 
这 样 就 用 不 着 重复 地 写 若干 行 相 同 的 代码 。JavaScript 有 三 种 不 同 种 类 的 循环 : for 循 
环 .while 循环 ,do…while 循环 。 

1. pr 循环 语句 


在 脚本 的 运行 次 数 已 确定 的 情况 下 使 用 for 循环 。for 循环 语句 是 循环 结构 语句 , 按 
照 指定 的 循环 次 数 .循环 执行 循环 体内 语句 (或 语句 块 ) 其 基本 结构 如 下 所 示 。 


for (表达 式 1; 表 达 式 2; 表 达 式 3) 
{ 
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需 执 行 的 循环 语句 
} 


表达 式 1 是 首 条 执行 的 语句 ,用 来 给 循环 变量 赋 初 始 值 ;表达 式 2 是 控制 循环 结束 与 
否 的 条 件 表达 式 .程序 每 执行 完 一 次 循环 体内 语句 (或 语句 块 ) .需要 重新 计算 包含 循环 变 
量 的 表达 式 值 , 若 为 true 则 继续 运行 下 一 次 循环 体内 语句 (或 语句 块 ) , 若 为 false 则 跳出 


循环 体 ;表达 式 3 指 循环 变量 更 新 的 方式 .程序 每 执行 完 一 次 
循环 体内 语句 (或 语句 块 ). 均 需要 更 新 循环 变量 。for 语句 执 
行 过 程 如 图 2-5 所 示 。 

下 面 范例 实现 计算 1 一 10 的 平方 .循环 变量 i 的 起 始 值 为 
1, 每 执行 一 次 循环 .i 的 值 就 会 累加 一 次 1, 循 环 会 一 直 运 行 
下 去 ,直到 i 等 于 10 为 止 。 例 中 使 用 浏览 器 内 置 对 象 
document 中 的 write 方法 输出 中 间 结 果 。 

【 例 2-18〗 〈 代 码 位 置 : \2\2. 2\square. htm) 


《Script type= “text/javascript “> 
var i=1; 

for(i=1;i<=10;i++) 

{ 

} 
</script> 


范例 运行 结果 如 下 所 示 。 


1*1=1 
2*2=4 
3*3=9 

4x* 4= 16 
5* 5=25 
6*6=36 
7*7=49 
8*8=64 
9x9=81 
10* 10= 100 


2. whie 循环 语句 





开始 





1 





for 





1 











表达 式 1 





false 
表达 式 2 
ms 





























while 循环 语句 用 于 在 指定 条 件 为 true 时 循环 执行 代码 .其 语法 结构 如 下 所 示 。 


while (表达 式 ) 
{ 

语句 块 ; 
} 
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表达 式 值 为 布尔 类 型 .用 于 控制 循环 结束 与 否 . 当 其 值 为 true 时 则 执行 循环 体 语句 
块 , 当 其 值 为 false 时 则 执行 结束 。 执 行 过 程 如 图 2-6 所 示 。 




















; 到 开始 
下 面 的 范例 用 于 计算 1+2 十 … 十 100 的 和 ,最 终 会 输出 - 
“1 十 2 十 … 十 100 的 和 为 :5050”。 

【 例 2-19〗 〈 代 码 位 置 : \2\2. 2\Sum. html) 表达 式 false 
《Script type= “text/javascript”> true 

var sum=0, i=1; 1 

while(i<=100) 循环 语句 

{ sum= sum+i; 














it+; a 

} 结束 
document. write(“1+ 2+…+100 的 和 为 :+ sum) ; 
《/script> 图 2-6 while 语句 














3. do…whie 循环 语句 

do…while 循环 是 while 循环 的 变种 .两 者 相 比 较 . do… 
while 语句 执行 至 少 一 次 循环 体 语句 ,而 while 语句 根据 循环 表达 式 可 以 执行 0 次 循环 体 
语句 。do…while 语法 结构 如 下 所 示 。 

















开始 
1 do 
do { 
三 = 二 = 全 语句 块 ; 
循环 语句 } 





while (表达 式 ) 

循环 语句 先 执行 语句 块 .再 计算 表达 式 值 , 当 表 达 式 为 
true 值 则 继续 执行 循环 体 语句 体 ,否则 结束 do…while 语句 。 
结束 执行 过 程 如 图 2-7 所 示 。 

下 面 的 范例 用 来 计算 9 的 阶乘 .范例 会 输出 “9 的 阶乘 
为 : 362880”。 
【 例 2-20】 〈 代 码 位 置 :\2\2. 2\Factorial. html) 




















2-7 do…while 语句 


<script language= ”javascript”> 
var sum= 1,i=1; 
do 
{ 
sum* =i; 
5 二 交 
}while (i¢<=9) 
document. write (“9 的 阶乘 为 : “+ sum) ; 
《</script> 
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4. break 和 conthue 语句 


break 可 用 在 for、while 和 do…while 循环 语句 内 部 . 它 可 以 终止 循环 语句 的 执行 . 然 
后 继续 执行 循环 之 后 的 代码 。 除 此 之 外 .break 语句 还 可 用 在 switch 语句 中 ,用 来 终止 
switch 语句 的 执行 。continue 语句 也 可 用 在 循环 语句 内 部 .其 作用 是 终止 当前 循环 .然后 
从 下 一 循环 继续 运行 。 例 2-21 是 break 和 continue 语句 范例 ,范例 会 输出 “该 数字 是 : 
Fk 


【 例 2-21】 (代码 位 置 : \2\2. 2\TestBreak. html) 


《Script type= “text/javascript”> 


var sum= 0; // 和 
var i; 
for (i=0; i<100; i++) { 
if (i %3==0) { // 能 被 3 整除 , 结束 本 次 循环 ,开始 下 一 次 循环 
continue; 
} 
sum= sum+ ii; // 对 不 能 被 3 整除 的 数 求 和 
if (sum> =2000) { // 和 超过 2000 终止 循环 
break; 


} 
} 
document. write(“ 该 数字 是 :“+i) ; 
《/script> 


5. br*…h 语句 


for…in 循环 语句 用 于 遍历 数组 元 素 或 者 对 象 属性 。for…in 每 次 循环 都 从 数组 中 取 
出 下 一 个 元 素 或 者 从 对 象 中 读 出 下 一 次 属性 ,其 语法 如 下 所 示 。 


for (var 变量 in 对 象 或 数组 ) 
{ 

语句 块 ; 
} 


每 次 循环 .“ 变 量 " 指 向 下 一 个 数组 元 素 下 标 或 下 一 个 对 象 属性 名 。 下 面 的 范例 使 用 
for…in 循环 遍历 数组 .会 输出 “ 张 三 李 四 老 五 孙 上 阴 ”。 
【 例 2-22】 (代码 位 置 : \2\2. 2\MyCar. html) 


《Script type= “text/javascript”> 
Var x; 
var mycars=new Array() ; 
mycars[0]=“ 张 三 ; 
mycars[1]=“ 李 四 ”; 
mycars[2]=“ 老 五 ”; 
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mycars[3]=“ 孙 明 ”; 


for (x in mycars) 


由 
document. write (mycars[x]+“&nbsp;”); 
} 
</script> 
2.3 JavaScrpbt 数 组 、 函 数 和 对 象 
2.3.1 数组 


JavaScript 数组 跟 变 量 一 样 .都 是 用 来 存放 数据 的 ,但 普通 变量 只 可 以 存储 单个 数 
据 ,而 数组 可 以 存储 多 个 数据 。 数 组 中 存储 的 数据 称 为 元 素 , 元 素 由 数组 下 标 标识 ,下 标 
可 以 是 数值 ,也 可 以 是 字符 串 。 数 组 使 用 前 需要 通过 关键 字 “*new Array” 创 建 。 下 面 是 
创建 数组 的 范例 , 例 中 创建 了 两 个 数组 arrayObj 和 arrayObjl ,arrayObj 没有 指定 数组 大 
小 ,而 arrayObjl 指定 数组 大 小 为 10. 表 示 数 组 占用 10 个 元 素 空 间 。 

array0bj =new Array(); 

array0bjl =new Array(10) ; 


创建 数组 后 ,能 够 用 [ ] 符号 访问 数组 单个 元 素 , 数 组 的 属性 length 表示 数组 长 度 。 
下 面 的 范例 描述 的 是 如 何 创建 以 及 使 用 数组 。 
【 例 2-23】 (代码 位 置 : \2\2. 3\array_example. html) 


《Script type= “text/JavaScript”> 
var my_array=new Array() ; // 创 建 数 组 
for (i=0; i<10; i++) 
{ 


my_array [i]=i; // 往 数组 中 添加 元 素 
} 
x=my_array [4]; // 读 出 下 标 为 4 的 数组 元 素 
alert (x); // 输 出 4 
alert (my_array. length) ; // 输 出 数组 长 度 10 
《</script> 
2.3.2 函数 
1. 自 定义 函数 


函数 为 程序 设计 人 员 提 供 了 一 个 非常 方便 的 能 力 。 通 常 在 进行 一 个 复杂 的 程序 设计 
对 ,总 是 根据 所 要 完成 的 功能 .将 程序 划分 为 一 些 相 对 独立 的 部 分 ,每 部 分 编写 一 个 函数 。 
从 而 使 各 部 分 充分 独立 ,任务 单一 .程序 清晰 . 易 懂 、 易 读 、 易 维护 。JavaScript 函数 的 自 
定义 格式 如 下 所 示 。 
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function 自 定义 函数 名 ( 形 参 1, 形 参 2,…) 
{ 
函数 体 

function 是 定义 函数 的 关键 字 。 函 数 名 用 于 定义 自己 函数 的 名 字 。 定 义 函 数 时 指定 
的 参数 称 为 形式 参数 .简称 形 参 , 形 参数 量 可 以 为 0 个 或 多 个 。 通 过 形 参 函数 体 可 以 处 理 
外 部 传递 过 来 的 数据 。 函数 体 是 实现 一 定 功能 的 代码 。 调 用 函数 时 实际 传递 的 值 称 为 实 
际 参 数 ,简称 实 参 , 实 参 数量 应 该 要 和 形 参 数量 一 致 。 当 使 用 多 个 参数 时 ,函数 调用 所 给 
出 的 各 个 实 参 按照 其 排列 的 先后 顺序 依次 传递 给 函数 定义 中 的 形 参 . 函数 调用 形式 如 下 
所 示 。 


函数 名 ( 实 参 1, 实 参 2,…) 


下 面 是 描述 函数 的 范例 ,范例 定义 了 一 个 含有 参数 的 函数 ,函数 名 为 Show ,name 和 
text 是 函数 的 形 参 , 字 符 串 “Show” 和 "function is called” 是 函数 的 实 参 ,函数 的 作用 是 把 
参数 text 中 的 字符 串 显 示 在 页 面 上 上。 范例 运行 后 会 显示 “Show function is called”。 

【 例 2-24】 〈 代 码 位 置 : \2\2. 3\function_example. html) 


《script language= javascript> 
function Show (name, text) 
{ 
document. write (name+ ” “+text); 
} 
Show(”Show”, "function is called”); 
</script> 


如 果 自 定义 函数 有 返回 值 .可 以 在 函数 体 中 使 用 return 把 值 返 回 给 调用 者 。return 
格式 如 下 所 示 。 


return 表达 式 ; 


这 条 语句 的 作用 是 结束 函数 .并 把 其 后 的 表达 式 的 值 作为 函数 的 返回 值 。 例 2-25 是 
return 范例 .编写 一 个 求 两 个 数 中 的 最 大 值 的 函数 Max(x.y)。 
【 例 2-25】 (代码 位 置 : \2\2. 3\Max_function_example. html) 


“Script language= javascript> 
function Max (x, y) 
{ 
if (x>y) 
return x; 
else 
return y; 
} 
Var Zi 


zl=Math.random() ; // 调 用 预定 义 函 数 Math. random 随机 生成 0 1 之 间 的 数 
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z2= Math. random() ; // 随 机 生成 0 1 之 间 的 数 
z=Max (z1, 22) ; // 求 z1,z2 中 的 最 大 数 
document. write(Max("+zl+”, ”+22+")="+2); 
</script> 
在 JavaScript 中 ,每 个 函数 都 会 返回 值 。 如 果 一 个 函数 没有 执行 return 语句 ,那么 也 
会 返回 undefined。 
2. 预定 义 函 数 
使 用 JavaScript 的 预定 义 函 数 可 提高 编程 效率 ,预定 义 函 数 是 指 JavaScript 已 定义 
好 具有 一 定 功 能 的 函数 ,可 分 为 数学 .数字 .字符 串 .日 期 .正则 式 和 数组 等 类 别 预 定义 
函数 。 
1) 数学 函数 
JavaScript 提供 Math 对 象 用 于 执行 数学 任务 ,使 用 Math 对 象 中 的 方法 可 以 不 需要 
创建 Math 对 象 ,直接 调用 Math 对 象 中 的 方法 。 下 面 是 使 用 数学 函数 求 圆 面积 的 范例 ， 
圆 半 径 为 10 ,范例 会 输出 圆 的 面积 314. 159 265 358 979 3。 
【 例 2-26】 〈 代 码 位 置 :\2\2. 3\mathematical functions. html) 


《script language= javascript> 


var mypi=Math.PI; // 获 取 PI, 3. 141592653589793 
var r=10; 
var area= Math. pow (r, 2) * mypi; //pow 为 计算 r 的 平方 值 
alert (area) ; // 输 出 314. 1592653589793 
</script> 
2) 日 期 函数 


JavaScript 提供 了 Date 对 象 进行 时 间 和 日 期 的 计算 。 无论 是 获取 日 期 时 间 .设置 日 
期 时 间 和 判断 日 期 时 间 等 操作 都 可 以 借助 Date 对 象 中 的 方法 来 实现 ,使 用 日 期 函数 之 前 
需要 创建 Date 对 象 。 例 2-27 是 日 期 函数 范例 .输出 当前 的 年 月 日 。 

【 例 2-27】 〈 代 码 位 置 :\2\2. 3\date_function. html) 


“script language= javascript> 
var mydate=new Date(); 
var str=mydate. getFullYear ()+ “年 “+mydate. getMonth()+ “月 "+mydate. getDay 0+ “日 ~; 
alert(str) ; 
《/script> 
3) 数组 函数 
通过 数组 提供 的 方法 可 以 实现 元 素 添加 删除 排序. 字符 串 化 .数组 复制 .获取 数组 
长 度 、 数 组 分 割 .数组 合并 等 操作 。 下 面 是 数组 操作 范例 .其 中 创建 了 两 个 数组 array12 
和 array10, 并 对 数组 进行 元 素 添加 和 删除 操作 。 
【 例 2-28〗 (代码 位 置 : \2\2. 3\array_function. html) 
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< script type= “text/JavaScript”> 
var array12= [1, 2, 3, 4] ; 


array12[5]=5; // 添 加 元 素 
array12. push (6) // 添 加 元 素 
array12. shift () ; // 移 除 最 前 一 个 元 素 
for(var a in arrayl2) 
document. write(arrayl2[a]+ </br> ”); // 输 出 2, 3, 4, 5,6 


var array10= [1, 2, 3, 4] ; 

array10. pop () ; // 移 除 最 后 一 个 元 素 并 返回 该 元 素 值 

document. write (array10. toString ()) ; // 输 出 ”1,2,3” 
/script> 


4) 字符 串 函 数 

通过 字符 串 对 象 提 供 的 方法 可 以 实现 字符 串 连接 、 分 割 . 取 子 串 .查找 子 串 .字符 大 小 
写 变换 等 操作 。 下 面 是 字符 串 范例 .其 中 对 字符 串 进行 了 连接 、 分 割 和 取 长 度 等 操作 。 

【 例 2-29】〗 (代码 位 置 : \2\2. 3\string {function. html) 

《Script type= “text/JavaScript”> 


var a= “hello”; 
var b=", world”; 


var c=a. concat (b) ; // 连 接 字符 串 a 和 b 
document. write(c+ "< /br> ”); // 输 出 hello, world 
var arrl=a. split (””); // 分 割 字符 串 a 
for (var key in arrl) 
document. write(arrl[key]+” &nbsp; “); // 输 出 hello 

document. write(”< /br> “); 
var len=a. length; // 取 字符 串 a 的 长 度 
document. write(len) ; // 输 出 5 

</script> 

5) 其 他 函数 


JavaScript 函数 库 远 不 止 前 述 内 容 . 还 提供 了 字符 串 转 数字 .URL 或 URI 编码 和 反 
编码 等 函数 。 以 函数 parseInt 为 例 . 它 可 将 字符 串 解 尽 可 能 地 转换 为 整数 .如 parseInt 
("123") parselInt ("123. 45")、parselInt ("123. 45abc") 都 返回 整数 123, 而 parseInt 
("abc123") 和 parselInt(true) 返 回 NaN。 


2.3.3 对象 


相对 于 数字 、 字 符 和 布尔 型 原始 数据 类 型 而 言 .对 象 是 一 种 复合 的 、 复 杂 的 数据 类 型 。 
什么 是 对 象 ? 教室 中 的 一 个 课 桌 是 一 个 对 象 .一 草 电 灯 是 一 个 对 象 .一 部 手机 是 一 个 对 
象 . 一 人 台 计 算 机 也 是 一 个 对 象 .可 以 说 .能 看 得 见 、 摸 得 着 的 万 事 万 物 都 是 对 象 。 如 何 描述 
一 个 对 象 ? 以 一 部 手机 对 象 为 例 . 一 部 手机 是 “黑色 的 、 正 方 体 的 .小米 生产 的 、5 克 重 的 ， 
可 以 打 电 话 的 ”东西 。 描 述 手 机 所 提 及 的 颜色 、 形 状 、 品 牌 、 重 量 都 是 手机 对 象 的 属性 . 打 
电话 是 手机 对 象 的 方法 。 可 以 这 样 认为 .对 象 是 属性 和 方法 的 集合 。 JavaScript 中 的 所 
有 事物 都 是 对 象 .这 些 事物 包括 字符 串 .数值 .数组 和 函数 等 :因为 它们 都 拥有 自己 的 属性 
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和 方法 .例如 ,可 以 通过 字符 串 对 象 的 length 属性 获取 字符 串 长 度 . 通 过 字符 串 对 象 的 方 
法 concat 连接 新 字符 串 。 

JavaScript 语言 是 基于 对 象 的 语言 .基于 对 象 而 不 是 面向 对 象 的 主要 是 因为 它 没有 
提供 像 抽 象 .继承 . 重 载 等 有 关 面 向 对 象 语 言 的 许多 功能 。 而 是 把 其 他 语言 所 创建 的 复杂 
对 象 统一 起 来 .从 而 形成 一 个 非常 强大 的 对 象 系统 。 虽 然 JavaScript 语言 是 一 门 基于 对 
象 的 语言 ,但 它 还 是 具有 一 些 面向 对 象 的 基本 特征 。 它 可 以 根据 需要 创建 自己 的 对 象 ,从 
而 进一步 扩大 JavaScript 的 应 用 范围 .增强 编写 功能 强大 的 Web 文档 。 


1. 创建 对 象 


JavaScript 的 对 象 可 以 通过 关键 字 new 来 创建 。 下 面 是 创建 对 象 的 范例 ,创建 了 三 
个 对 象 ,输出 “实例 初始 化 “Stringmyfunction” 和 “为 对 象 新 添 的 属性 msg”。 
【 例 2-30】 (代码 位 置 : \2\2. 3\create_object. html) 
<script type= “text/JavaScript”> 
var str=new String(“ 实 例 初始 化 String”); // 创 建 字符 串 对 象 


document. write(str+ “< /br> ”); 


var func=new Function(”x”,” document.write(x +”</br>” ) ); 


// 创 建 Function 对 象 
func (“myfunction”); // 输 出 myfunction 
var o=new Object () ; // 创 建 Object 对 象 


o.msg= 为 对 象 新 添 的 属性 msg”; 
document. write(o.msg) ; 
《/script> 


2. 对 象 属性 和 方法 的 引用 


对 象 属性 的 引用 可 由 点 (. ) 运 算 符 .数字 下 标 和 字符 串 下 标 三 种 方式 实现 。 对 象 方法 
可 通过 点 (. ) 运 算 符 引用 。 下 面 是 对 象 属性 和 方法 引用 的 范例 。 
【 例 2-31】 (代码 位 置 ; \2\2. 3\reference_object_method. html) 


《Script type= “text/JavaScript”> 


alert( Math. PI ) ; //. 运 算 符 引用 对 象 属性 
alert( Math[”PI”] ) ; // 字 符 串 下 标 引 用 对 象 属性 
var str=“HELLO”; 

alert (str[0]); // 数 字 下 标 引 用 对 象 属性 


var mydate=new Date(); 
alert (mydate. getFullYear() ) ; //. 运 算 符 引用 对 象 方法 
《/script> 


3. 自 定义 对 象 
JavaScript 对 象 可 分 为 自 定义 和 预定 义 对 象 。 要 使 用 预定 义 对 象 ,可 先 通过 关键 字 
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new 创建 对 象 再 访问 对 象 .或 者 直接 访问 预定 义 对 象 即 可 。 但 如 果 预 定义 对 象 不 能 满足 
应 用 的 需求 . 则 需要 自 定义 创建 对 象 。 有 很 多 方法 可 以 自 定义 对 象 ,下 面 展 示 了 使 用 
Object 构造 函数 、 自 定义 构造 函数 .原型 结合 构造 函数 三 类 方法 定义 对 象 的 方法 。 

下 面 的 范例 使 用 Object 创建 了 一 个 person 对 象 ,为 对 象 动态 添加 了 name 和 age 两 
个 属性 ,并 用 两 种 方式 读 取 对 象 属性 .输出 “ 张 三 " 和 *30”。 

【 例 2-32】 (代码 位 置 ; \2\2. 3\custom objects. html) 


《Script type= “text/JavaScript”> 
var person=new Object (); 
person. name=“ 张 三 ”; 
person. age= 30; 
alert (person. name) ; 
alert (person[”age”]); 
</script> 


下 面 的 范例 使 用 自 定义 函数 创建 了 一 个 Person 对 象 ,有 name、age 和 sex 属性 ,以 及 
sayName 方法 ,方法 的 作用 是 输出 属性 值 。 为 了 让 Person 有 别 于 自 定义 函数 ,Person 函 
数 的 首 字 母 要 大 写 , 以 此 表示 这 是 一 个 对 象 。 范 例会 输出 * 张 三 “30” 和 ”* 男 ”。 这 种 方法 
可 以 实现 对 象 的 数据 彼此 独立 ,但 不 足 的 是 每 个 对 象 的 方法 都 是 指向 不 同 的 函数 实例 。 

【 例 2-33〗 (代码 位 置 : \2\2. 3\objectL method. html) 


< script type= “text/JavaScript”> 
function Person (name, age, sex) 
{ 
this. name= name; 
this. age= age; 
this. sex= sex; 
this. sayName= function() 
. 
alert (this.name+ “\n”+this.age+“\n”+this. sex); 
于 
} 
var person=new Person(” 张 三 ”, 30,“ 男 ); 
person. sayName () ; 


/script> 


范例 中 使 用 到 了 this 关键 字 .this 关键 字 表示 对 当前 对 象 的 引用 。 由 于 对 象 的 引用 
是 多 层次 、 多 方位 的 .往往 一 个 对 象 的 引用 又 需要 对 另 一 个 对 象 的 引用 .而 另 一 个 对 象 有 
可 能 又 要 引用 另 一 个 对 象 . 这 样 有 可 能 造成 混乱 .最 终 弄 不 清 引 用 的 是 哪 一 个 对 象 .为 此 
JavaScript 提供 了 一 个 用 于 将 对 象 指定 为 当前 对 象 的 关键 字 this。 

下 面 是 使 用 原型 组 合 函 数 创建 对 象 的 范例 .这 个 范例 创建 了 personl 和 person2 两 
个 对 象 ,这 两 个 对 象 共享 一 个 方法 sayFriends 实例 .但 不 共享 对 象 数据 .数据 彼此 独立 。 
每 创建 一 个 Person 对 象 .这 个 对 象 就 拥有 一 个 prototype 属性 ,这 个 属性 指向 同一 个 函数 
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对 象 。 这 种 方法 是 使 用 最 广泛 .认同 度 最 高 的 创建 对 象 的 方法 。 
【 例 2-34】 (代码 位 置 ; \2\2. 3\object sharing_ method. html) 


《Script type= “text/JavaScript”> 
function Person (name, age, sex) 
{ 
this. name= name; 
this. age= age; 
this. sex= sex; 
this. friends=[“ 张 三 ”,“ 李 四 "]; 
. 
Person. prototype. sayFriends= function() 
{ 
alert (this. friends); 
}; 
var person1=new Person(“ 李 表明 “, 31,“ 男 ); 
var person2=new Person(” 王 某 某 ”, 30,“ 男 ); 
personl. friends. push(“ 老 五 ); 


personl. sayFriends(); // 输 出 张 三 , 李 四 和 老 五 
person2. sayFriends () ; // 输 出 张 三 , 李 四 
</script> 


24 XML 和 JSON 


2.4.1 什么 是 XML 


XML(Extensible Markup Language) 中文 名 为 可 扩展 标记 语言 ,是 标准 通用 标记 语 
言 的 子 集 。XML 是 一 种 用 于 标记 电子 文件 使 其 具有 结构 性 的 标记 语言 。1998 年 ,W3C 
发 布 了 XML1. 0 规范 .使 用 它 来 简化 Internet 的 文档 信息 传输 。 现 在 XML 已 成 为 各 种 
应 用 程序 之 间 进 行 数据 传输 的 最 常用 工具 。XML 之 所 以 成 为 应 用 程序 间 数 据 传 输 的 常 
用 工具 ,是 因为 它 能 简单 化 数据 的 存储 和 共享 .具体 作用 如 下 。 


1.XML 把 数据 从 HTML 中 分 离 


如 果 需 要 在 HTML 文档 中 显示 动态 数据 .那么 每 当 数 据 改 变 时 将 花费 大 量 的 时 间 
来 编辑 HTML。 通 过 XML .数据 能 够 存储 在 独立 的 XML 文件 中 .这样 就 可 以 专注 于 使 
用 HTML 进行 布局 和 显示 .并 确保 修改 底层 数据 不 再 需要 对 HTML 进行 任何 的 改变 。 
通过 使 用 几 行 JavaScript 代码 .就 可 以 读 取 一 个 外 部 XML 文件 .然后 更 新 HTML 中 的 
数据 内 容 。 


2. XML 简化 数据 共享 
在 真实 的 世界 中 .计算 机 系统 和 数据 使 用 不 兼容 的 格式 来 存储 数据 。XML 数据 以 
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纯 文本 格式 进行 存储 ,因此 提供 了 一 种 独立 于 软件 和 硬件 的 数据 存储 方法 。 这 让 创建 不 
同 应 用 程序 可 以 共享 的 数据 变 得 更 加 容易 。 


3. XML 简化 数据 传输 


通过 XML, 可 以 在 不 兼容 的 系统 之 间 轻 松 地 交换 数据 。 对 开发 人 员 来 说 ,其 中 一 项 
最 费时 的 挑战 一 直 是 在 因特网 上 的 不 兼容 系统 之 间 交 换 数据 。 由 于 可 以 通过 各 种 不 兼容 
的 应 用 程序 来 读 取 数据 ,以 XML 交换 数据 降低 了 这 种 复杂 性 。 


4. XML 简化 平台 的 变更 


升级 到 新 的 系统 (硬件 或 软件 平台 ) 总 是 非常 费时 的 ,必须 转换 大 量 的 数据 ,不 兼容 的 
数据 经 常会 丢失 。XML 数据 以 文本 格式 存储 。 这 使 得 XML 在 不 损失 数据 的 情况 下 ,更 
容易 扩展 或 升级 到 新 的 操作 系统 、 新 应 用 程序 或 新 的 浏览 器 。 


5. XML 使 数据 更 有 用 


由 于 XML 独立 于 硬件 .软件 以 及 应 用 程序 .XML 使 数据 更 可 用 .也 更 有 用 。 不 同 的 
应 用 程序 都 能 够 访问 数据 ,不 仅 在 HTML 页 中 .也 可 以 从 XML 数据 源 中 进行 访问 。 通 
过 XML, 数据 可 供 各 种 阅读 设备 使 用 (手持 的 计算 机 、 语 音 设 备 .新 闻 阅 读 器 等 ) .还 可 以 
供 盲人 或 其 他 残障 人 士 使 用 。 


6. XML 用 于 创建 新 的 nemet 语 言 


很 多 新 的 Internet 语言 是 通过 XML 创建 的 ,其 中 的 例子 包括 XHTML、WSDL、 
WML .RSS 和 SMIL 等 。 

除 此 之 外 .XML 还 能 适用 于 移动 互联 网 应 用 开发 ,例如 ,XML 是 Android 原生 态 界 
面 的 主要 开发 语言 。 


2.4.2 XML 基础 


XML 被 设计 用 来 结构 化 .传输 和 存储 数据 。 从 结构 上 看 . 它 由 XML 声明 和 元 素 组 
成 。XML 声明 指定 了 XML 文档 所 用 的 XML 版 本 和 编码 。 元 素 用 于 描述 数据 的 结构 和 
含义 。 元 素 由 开始 标签 .结束 标签 和 元 素 内 容 组 成 。XML 标签 没有 被 预定 义 : 使 用 时 需 
要 自行 定义 标签 。 开 始 标 签 和 结束 标签 必须 要 配对 .而 且 标签 名 大 小 敏感 。 整 个 XML 
只 有 一 个 根 元 素 . 根 元 素 可 以 赃 套 子 元 素 . 子 元 素 也 是 可 以 谋 套 的 .元 素 彼此 间 构 成 树 状 
结构 。 元 素 内 容 除了 可 以 嵌 套 子 元 素 . 还 可 以 是 文本 内 容 。 除 了 可 以 用 元 素描 述 数 据 外 . 
还 可 以 在 说 有 子 元 素 的 开始 标签 中 使 用 属性 描述 数据 .属性 值 必须 用 单 引 号 或 双 引 号 括 
起 来 。 下 面 的 范例 用 于 传送 一 条 留言 信息 。 

【 例 2-35】 (代码 位 置 : \2\2. 4\xml_example. xml) 

《< ?xml version=“1.0” encoding=“IS0- 8859- 1”?> //XML 声明 

《note> 

< to> tomc /to> 
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《from> perryYK/from> 

《heading> Reminder< /heading> 

《body>Don t forget the meeting!< /body> 
/note> 


上 述 范例 描述 了 发 送 者 .接收 者 .留言 标题 和 留言 信息 ,这 些 留 言 信息 要 传送 和 储存 ， 
需要 包装 在 XML 文档 中 。 文 档 首 行 是 XML 声明 , 它 由 version 和 encoding 属性 指定 
XML 版 本 和 文档 编码 。 一 to 二 .一 from 二 、 一 heading 二 、 一 body 二 和 一 note 二 等 是 起 始 
标签 .一 /to 二 一 /from 二 一 /heading 二 、 一 /body 二 和 一 /note 二 等 是 结束 标签 。note 是 
根 元 素 , 它 含有 4 个 元 素 , 分 别 是 to ,from .heading 和 body 子 元 素 , 这 4 个 子 元 素 的 内 容 
为 文本 内 容 。 


2.4.3 什么 是 JSON 


JSON(JavaScript Object Notation) 是 一 种 轻 量 级 的 数据 交换 格式 。JSON 采用 完全 
独立 于 开发 语言 的 文本 格式 描述 数据 , 它 是 最 常用 的 数据 交换 语言 。 JSON 的 特点 是 易 
于 人 阅读 和 编写 ,同时 也 易于 程序 解析 和 网 络 传输 速度 ,这 也 使 得 它 成 为 理想 的 数据 交换 
语言 。JSON 使 用 JavaScript 语法 来 描述 数据 对 象 . 但 是 JSON 仍然 独立 于 语言 和 平台 。 
JSON 解析 器 和 JSON 库 支 持 许多 不 同 的 编程 语言 。 


2.4.4 JSON 基础 


JSON 可 以 描述 开发 语言 中 的 对 象 和 数组 两 种 复合 数据 结构 。 在 JSON 中 ,对 象 由 
一 系列 键 名 / 键 值 对 组 成 。 一 个 对 象 以 左 花 括 号 "(" 开 始 ,以 右 花 括号 ")" 结 束 。 对 象 中 所 
有 的 键 名 / 键 值 对 都 落 在 这 两 个 符号 内 。“ 键 名 "和 “ 键 值 " 以 “: "分 隔 .不 同 键 名 键 值 对 以 
逗号 分 隔 。JSON 对 象 具体 定义 如 下 所 示 。 


{“ 键 名 1”: 键 值 , “ 键 名 2”: 键 值 ,…,“ 键 名 n”: 键 值 ,} 

JSON 数组 以 左 中 括号 *[ "开始. 以 右 中 括号 *]" 结 束 。 所 有 的 数组 元 素 必须 写 在 这 
两 个 符号 之 间 。 元 素 值 之 间 使 用 逗号 *.“ 分 隔 。]SON 数组 具体 定义 格式 如 下 所 示 。 

[ 元 素 值 1, 元 素 值 2, 元 素 值 3, …, 元 素 值 n ] 

无 论 键 值 还 是 元 素 值 .其 值 可 以 是 字符 串 、 布 尔 值 .整数 和 浮 点 数 等 。 下 面 是 一 个 
JSON 范例 , 例 中 把 JSON 转换 成 JavaScript 对 象 和 数组 .通过 对 象 和 数组 的 方式 可 以 访 
问 数据 。 

【 例 2-36】 (代码 位 置 : \2\2. 4\json_example. xml) 


《Script type= “text/JavaScript”> 
function show() { 
var user= 
{ 
“username”:“ 张 三 ， 
”age” :30, 
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"dn El 
“address”: 


[ 
{city”:” 上 海 ”, “postcode”:”222222”}， 
{city”:“ 广 州 ", “postcode”:”333333”} 


} 
alert (“username:”+user. username); 
alert ("age:”+user. age); 
alert (“tell:”+user. info. tell); 
alert (“tel2:”+user. info. tel2); 
alert(“city: “+user.address[0]. city); 
alert(”postcode:”+user.address[0]. postcode); 
alert ("city: “+user.address[1]. city); 
alert ("postcode:”+user.address[1]. postcode); 
} 
show(); 
</script> 


程序 间 通 常 是 传递 JSON 字符 串 来 交换 数据 的 ,能 不 能 把 JSON 字符 串 转换 成 
JavaScript 对 象 和 数组 呢 ? 回答 是 肯定 的 .利用 eval 函数 是 一 种 简单 而 直接 的 转换 方法 。 
在 转化 的 时 候 需要 将 JSON 字符 串 的 外 面包 装 一 层 圆 括号 。eval 函数 具体 格式 如 下 
所 示 。 


var jsonObject=eval(" (“+ jsonFormat+ “)”); 


jsonFormat 是 JSON 字符 串 .jsonObject 是 JSON 字符 串 转换 成 数组 或 对 象 后 的 变 
量 。eval 中 为 什么 要 加 括号 ? 加 上 圆 括 号 的 目的 是 迫使 eval 函数 在 评估 JavaScript 代码 
的 时 候 强 制 将 括号 内 的 表达 式 (expression) 转化 为 对 象 或 数组 .而 不 是 作为 语句 
(statement) 来 执行 。 

下 面 是 JavaScript 把 JSON 字符 串 转换 成 对 象 和 数组 的 范例 .转换 后 可 以 用 对 象 和 
数组 的 方式 访问 数据 。 

【 例 2-37】 (代码 位 置 ; \2\2. 4\json_string_converted. html) 


《Script type= “text/JavaScript”> 


var strJSON=“{fname:" 张 三 " ，age:30，sex:true, salary:3000. 55}”; //JSON 字符 串 
var obj=eval(“(“+ strJSON+ ”)” ); // 转 换 后 的 JSON 对 象 
alert (obj. name) ; // 对 象 属性 方式 访问 数据 


alert (obj. age) ; 
alert (obj. sex) ; 


alert (obj. salary) ; 


strJSON=“[ 张 三 ,30, true, 3000. 55]”; //JSON 字符 串 
arr=eval(“(“+ strJSON+ ”)” ); // 转 换 后 的 JSON 数组 
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alert (arr [0]) ; // 数 组 元 素 访问 数据 
alert (arr [1]); 
alert (arr [2]); 
alert (arr [3]); 
</script> 


2.5 Rhino 引擎 与 Java 语言 


JavaScript 一 直 是 脚本 语言 的 领头 羊 .是 一 门 具有 非常 丰富 特性 的 语言 ,使 用 灵活 方 
便 , 尤 其 是 内 置 的 轻 量 级 数据 类 型 JSON 使 得 JavaScript 更 加 强大 。Java 是 一 种 面向 对 
象 的 编译 型 语言 ,是 Android 应 用 的 主流 开发 语言 。 对 于 Java 程序 ,Java 首先 将 源 代码 
编译 成 二 进 制 字 节 码 (bytecode) ,然后 依赖 各 种 不 同 平台 上 的 虚拟 机 来 解释 执行 字 节 码 ， 
从 而 实现 了 “一 次 编译 .到 处 执行 "的 跨 平 台 特 性 。 对 于 Android, 二进制 字 节 码 文 件 ( 文 
件 扩 展 名 为 . class) 还 需要 转换 成 dalvik 字 节 码 文 件 才 可 以 在 Android 平台 运行 。 

Rhino 是 开源 的 JavaScript 引擎 .是 完全 基于 Java 实现 ,几乎 可 以 使 用 JavaScript 完 
成 Java 所 有 的 工作 。 它 可 以 提供 强大 的 计算 能 力 , 没 有 LO 的 限制 ,可 以 将 JavaScript 
编译 成 Java 字 节 码 , 具 有 良好 的 速度 和 性 能 。 在 Rhino 环境 中 既 可 以 使 用 JavaScript 脚 
本 语言 ,同时 也 可 以 非常 简单 地 使 用 Java 语言 的 某 些 工具 。 


2.5.1 搭建 Rhino 开发 环境 


要 在 PC 端 搭建 Rhino 环境 .需要 先 安 装 好 Java 环境 再 安装 Rhino 开发 环境 。 有 关 
Java 环境 可 参考 其 他 资料 。 开 发 者 可 以 从 官网 http://www. mozilla. org/rhino/ 下 载 
Rhino ,本 文 下 载 引 擎 文件 是 rhinol. 7R3. zip。 解 压 引 擎 文件 可 得 到 js. jar, 此 文件 为 
Rhino 对 应 的 jar 包 。 在 使 用 Rhino 之 前 ,需要 配置 环境 ,具体 做 法 是 将 js.jar 文件 加 入 
系统 的 环境 变量 CLASSPATH 中 。 

要 调用 JS 解释 器 需要 进入 Rhino 的 交互 模式 .进入 交互 模式 有 两 种 方式 。 第 一 种 是 
打开 控制 台 ,并 切换 ja. jar 文件 所 在 的 目录 .输入 “java -jar js. jar” 命 令 . 便 会 出 现 解 释 器 
的 版 本 信息 .并 进入 带 提示 符 js 二 的 命令 模式 。 第 二 种 方式 是 在 控制 台中 输入 "java org. 
mozilla. javascript. tools. shell. Main” ,同样 可 以 进入 带 提示 符 js 二 的 命令 模式 。 

现 假设 有 一 JS 文件 tools. js 存储 在 C 盘 根 目录 下 .其 代码 如 下 所 示 。 


var tools= {}; 
tools. testPlus= function (numl, num2) { 
return numl+ num2; 


} 

要 用 Rhino 执行 此 文件 .可 先 在 交互 模式 下 输入 “load("C: /tools. js")” 完 成 tools. js 
文件 的 加 载 。 注 意 在 此 处 “/”* 和 “\" 是 有 区 别 的 .不 能 换 用 。 再 输入 “tools. testPlus(1， 
2)”, 其 显示 执行 结果 为 3. 这 表明 JavaScript 代码 运行 成 功 。 要 退出 交互 模式 可 以 按 
Ctrl 十 Z 键 (Windows 系统 ) 或 Ctrl 十 DD 键 (Linux 或 UNIX 系统 ) 的 方式 退出 .也 可 以 调用 
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quit() 方 法 退出 。 
2.5.2 Rhino 和 Java 类 库 、 数 组 .对 象 和 接口 


Java 语法 规定 ,任何 代码 都 必须 以 class 文件 的 形式 存在 ,而 每 个 class 文件 必须 属 
于 一 个 package, 默 认为 default。 而 JavaScript 并 没有 类 似 package 的 层级 结构 概念 , 那 
么 如 何 使 用 Rhino 访问 Java 类 文件 呢 ? Rhino 定义 了 一 个 top-level 变量 Packages。 变 
量 Packages 对 应 的 所 有 属性 均 对 应 Java 包 名 。 比 如 . 某 个 Java 的 包 com. example 可 以 
写成 “Packages. com. example”。 为 简单 起 见 , 可 以 去 掉 变 量 Packages ,直接 输 入 Java 包 
名 。 因 此 ,Packages. com. example 和 com. example 等 价 。 假 如 要 访问 标准 的 Java 文件 
类 ,例如 要 访问 类 java. io. File, 为 避免 输入 全 名 ,可 先导 入 包 , 再 输入 Class 类 。 使 用 
importPackage 指令 可 导入 包 , 例 如 importPackage(java. io) 。 用 户 自 定义 的 包 也 可 以 被 
引用 进来 ,不 过 这 时 候 Packages 引用 不 能 被 省 略 。Rhino 通过 importClass 可 直接 导入 
类 ,例如 “importClass (java. io. File)” 表 示 导 入 类 java. io. File。 因 为 Rhino 定义 的 对 象 
Boolean .Math ` Number .Object 和 String 等 与 Java 语法 完全 不 同 , 因 此 两 者 无 法 等 价 。 

Rhino 使 用 Java 的 发 射 机 制 生成 数组 ,例如 ,代码 "array 王 java. lang. reflect. Array. 
newlInstance(java. lang. String,， 2) ”会 创建 一 个 数组 ,数组 包括 两 个 元 素 , 元 素 是 String 
数据 类 型 。Rhino 可 以 使 用 new 关键 字 创 建 Java 对 象 . 例 如 ,“new java. util. Date()" 会 
创建 一 个 日 期 对 象 。 

下 面 是 实现 Java 接口 的 范例 , 例 中 通过 JavaScript 语法 {propertyName: value} 声 明 
一 个 JavaScript 方法 run, 用 包含 run 方法 的 对 象 作为 接口 Runnable 的 参数 ,并 将 该 
Runnable 对 象 作 为 参数 .构造 了 一 个 新 的 线程 .并 启动 该 线程 。 


var obj= { run: function () {print(“\nrunning”); } } 
var r=new java. lang. Runnable (0bj); 

var t=new java. lang. Thread (r) ; 

t. start (); 
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SL4AA UIAPI 与 界面 开发 


UI 是 User Interface 的 简写 ,其 中 文 名 为 用 户 界面 。 它 是 系统 和 用 户 之 间 进 行 交互 
和 信息 交换 的 媒介 , 它 实现 信息 的 内 部 形式 与 人 类 可 以 接受 形式 之 间 的 转换 。 用 户 界面 
是 介 于 用 户 与 硬件 之 间 ,为 彼此 之 间 交 互 沟通 而 设计 的 相关 软件 ,使 得 用 户 能 够 方便 有 效 
地 去 操作 硬件 以 达成 双向 交互 ,完成 所 希望 的 工作 。 

用 户 界面 定义 广泛 ,包含 人 机 交互 与 图 形 用 户 界面 . 凡 参 与 人 类 与 机 械 的 信息 交流 的 
领域 都 存在 着 用 户 界面 。 

计算 机 图 形 用 户 界 面 一 般 指 介 于 用 户 与 计算 机 之 间 沟 通 与 交互 的 硬件 以 及 软 
件 , 目 的 在 于 使 得 计算 机 系统 用 户 能 够 方便 有 效 地 去 操作 计算 机 以 达成 双向 交互 ， 
完成 所 希望 借助 计算 机 完成 之 工作 ,其 涵盖 范围 包括 : 早期 由 纸 带 输入 设备 到 键盘 、 
鼠标 、 数 字 版 等 数据 输入 的 设备 ,显示 屏幕 、 声 音 等 输出 设备 .参考 文件 .联机 说 明 、 
教学 课程 等 辅助 使 用 材料 .人 机 交互 的 模式 达到 了 只 认识 1 与 0 的 计算 机 与 人 类 之 
间 的 用 户 接口 。 

在 图 形 用 户 界面 中 ,计算 机 画面 上 显示 窗口 .图 标 .按钮 等 图 形 表 示 不 同 目的 的 动作 ， 
用 户 通过 鼠标 等 指针 设备 进行 选择 。 

手机 用 户 界 面 是 用 户 与 手机 系统 .应 用 交互 的 窗口 .手机 界面 的 设计 必须 基于 手机 设 
备 的 物理 特性 和 系统 应 用 的 特性 进行 合理 的 设计 。 

尽管 SL4A 只 提供 了 Android 原生 态 服务 用 户 界 面 接口 API 的 子 集 .但 是 功能 非常 
强大 ,通过 这 些 接口 , 它 可 以 实现 电话 、 短 信 、 界 面 . 联 系 人 电池、 蓝牙 .WiFi、 多 媒体 、 摄 
像 .事件 、 多 媒体 播放 器 .传感器 和 程序 首选 项 等 功能 和 应 用 。 通 过 设备 或 模拟 器 上 的 
PHP 脚本 编辑 器 实现 了 “帮助 ”菜单 查看 所 有 的 API 文档 。 对 于 PHP 脚本 ,Android 接 
口 API 被 调用 后 ,其 运行 结果 都 会 返回 一 个 对 象 .该 对 象 包含 三 个 属性 : id ,result .error。 
id 用 于 标识 对 象 . 是 一 个 和 API 调用 相关 的 递增 的 数字 。result 是 API 调用 的 返回 结 
果 . 如 果 没 有 返回 其 值 为 null。error 表示 API 调用 错误 描述 . 当 没 有 错误 时 其 值 为 null。 

下 面 通过 一 个 PHP 脚本 来 认识 Android 接口 API 调 用 执行 过 程 。 此 范例 中 的 PHP 
脚本 调用 了 接口 方法 makeToast 在 屏幕 中 显示 了 字符 串 “Hello World”。 

< ?php 


require_once(”Android. php”); // 包 含 开发 Android 应 用 必须 的 文件 Android. php 
¥ droid=new Android() ; // 创 建 Android 对 象 
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¥obj=¥ droid- > makeToast ("Hello Worl1d”); // 调 用 Android 对 象 中 的 方法 makeToast 
2 


此 范例 首先 调用 函数 require_once 包含 头 文件 Android. php, 头 文件 含有 一 个 类 
Android ,然后 创建 一 个 Android 类 对 象 .再 调用 该 对 象 中 的 方法 函数 makeToast 在 屏幕 
上 显示 字符 串 “Hello World”, 该 方法 makeToast 执行 完毕 会 返回 一 个 对 象 . 对 象 包含 id、 
result 和 error 三 个 属性 ,由 于 makeToast 没有 返回 值 . 所 以 属性 result 的 值 是 空 。 

下 面 是 JavaScript 脚本 调用 Android 接口 API 的 实例 ,此 范例 中 的 JavaScript 脚本 
调用 了 接口 方法 makeToast 在 屏幕 中 显示 了 字符 串 “Hello World”。 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var obj= droid. makeToast (“Hello Wor1d”); 


此 例 先 通过 load 加 载 “/sdcard/com. googlecode. rhinoforandroid/extras/rhino/ 
android. js” 头 文件 ,此 头 文件 包含 Android 类 .然后 创建 了 一 个 Android 类 对 象 , 最 后 调 
用 该 对 象 中 的 方法 makeToast 在 屏幕 上 显示 字符 串 “Hello World”。 该 方法 makeToast 
执行 完毕 会 返回 执行 结果 赋 于 变量 obj. 由 于 该 方法 没有 返回 值 ,所 以 变量 obj 为 空 值 。 
这 里 需要 注意 的 是 ,JavaScript 的 返回 结果 并 没有 包含 id、result 和 error 属性 ,而 是 直接 
包含 返回 结果 值 。 

在 Android 平台 上 执行 编写 好 的 脚本 程序 : 首先 把 上 面 编写 好 的 代码 保存 为 脚本 文 
件 (test.js 或 test. php); 然 后 通过 执行 命令 “adb push 脚本 文件 /sdcard/sl4a/scripts/” 
把 文件 上 传 到 Android 模拟 器 /物理 机 中 .或 利用 豌豆 芋 等 软件 以 图 形 界 面 方式 把 文件 传 
输 到 Android 模拟 器 /物理 机 .这 样 开发 更 方便 、 更 高 效 ;最 后 在 Android 模拟 器 /物理 机 
中 ,打开 SL4A 管理 器 单 击 脚 本 程序 的 图 标 运行 该 脚本 程序 。 

SL4A 支持 三 种 方式 实现 界面 : UiFacade、WebView、FullScreeenUI。UiFacade 界 
面 通过 Android 界面 API 实现 对 话 框 和 进度 条 等 操作 . 它 提供 了 直接 操作 对 话 框 和 菜单 
的 方法 .这 种 方式 不 能 实现 全 屏 界面 .只 适合 简单 的 应 用 .如 警告 对 话 框 ,列表 对 话 框 等 。 
本 章 将 介绍 UiFacade 实现 界面 。 

对 话 框 是 用 来 提示 用 户 去 做 出 选择 或 输入 相应 信息 的 小 窗口 . 它 不 填充 屏幕 ,通常 被 
用 于 在 执行 前 需要 用 户 做 出 决定 的 模 态 事件 ,也 就 是 说 . 当 一 个 对 话 框 弹 出 后 .用户 只 能 
与 该 对 话 框 进行 交互 . 当 用 户 对 该 对 话 框 做 出 选择 操作 后 .才能 操作 其 他 程序 。 例如, 手 
机 没有 SIM 卡 或 SIM 卡 没有 插 好 时 .用 户 单 击 通话 设置 时 ,会 弹出 一 个 对 话 框 ,提醒 用 
户 SIM 卡 出 错 .这 时 用 户 只 能 与 该 对 话 框 交 互 .用 户 单 击 “ 确 定 ” 按 钮 后 .才能 操作 其 他 
程序 。 

Android API 支持 : 警告 对 话 框 、 列 表 对 话 框 , 单 选 框 和 复 选 框 \ 时 间 设 置 对 话 框 日 
期 设置 对 话 框 \ 水 平 进度 条 等 对 话 框 。 
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3.1 警告 对 话 框 和 对 话 框 按钮 


用 户 经 常会 与 警告 对 话 框 交互 会 话 , 警 告 对 话 框 常用 于 警告 .提醒 用 户 是 否 继 续 进 行 
一 些 危险 的 、 不 可 逆转 的 操作 。 例 如 ,用户 在 手机 删除 资料 的 时 候 , 会 弹出 一 个 相应 的 警 
告 对 话 框 ,提醒 用 户 是 否 确定 删除 选择 的 资料 。 

一 个 警告 对 话 框 有 三 个 区 域 : 标题 区 、 内 容 区 、 操 作 按钮 。 标 题 区 用 于 显示 该 对 话 框 
的 标题 ,内 容 区 用 于 显示 一 条 相关 信息 ,用 户 通 过 单 击 操作 按钮 触发 相应 事件 实现 用 户 某 
种 操作 。 操 作 按 钮 可 分 为 三 种 类 型 ,具体 如 下 所 示 。 

(1) 肯定 按钮 : 用 户 使 用 这 种 按钮 来 接收 和 继续 执行 相应 的 操作 。 

(2) 否定 按钮 : 用 户 使 用 这 种 按钮 来 取消 或 终止 相应 的 操作 。 

(3) 中 立 按钮 : 用 户 既 不 想 继续 执行 这 个 操作 又 不 想 取消 、 终 止 该 操作 时 ,使 用 这 种 
按钮 。 

在 警告 对 话 框 里 最 多 只 能 设置 三 个 操作 按钮 .对 于 每 种 类 型 的 按钮 ,只 能 添加 一 个 到 
警告 对 话 框 中 ,按钮 上 所 显示 的 文字 是 可 以 根据 需要 设置 的 。 如 在 关机 对 话 框 中 ,标题 区 
显示 的 标题 是 “关机 ”, 内 容 区 显示 的 信息 是 “您 的 手机 会 关机 ”, 该 对 话 框 包含 一 个 否定 按 
钮 ,按钮 上 显示 的 文字 为 “取消 ,用 户 单 击 该 按钮 执行 取消 关机 操作 ,还 包含 一 个 肯定 按 
钮 ,按钮 上 显示 的 文字 为 “确定 ”, 用 户 单 击 该 按钮 执行 关机 操作 。 

下 面 介 绍 创建 警告 对 话 框 和 对 话 框 按钮 相关 的 函数 : 


dialogCreateAlert( String title[optional], String message[optional]) 


该 函数 用 于 创建 一 个 警告 对 话 框 ,其 中 ,参数 title 表示 被 创建 对 话 框 的 标题 ,参数 
message 表示 被 创建 对 话 框 的 内 容 , 这 两 个 参数 都 是 可 选 的 。 


dialogSetPositiveButtonText (String text) 

该 函数 用 于 设置 对 话 框 肯定 按钮 文字 ,参数 text 表示 按钮 显示 的 文字 。 

dialogSetNegativeButtonText (String text) 

该 函数 用 于 设置 对 话 框 否定 按钮 文字 ,参数 text 表示 按钮 显示 的 文字 。 

dialogSetNeutralButtonText (String text) 

该 函数 用 于 设置 对 话 框 中 立 按钮 文字 ,参数 text 表示 按钮 显示 的 文字 。 

dialogGetResponse() 

该 函数 用 于 等 待 用 户 在 对 话 框 中 输入 信息 .并 且 得 到 对 话 框 响应 。 

dialogShow() 

该 函数 用 于 显示 对 话 框 。 

警告 对 话 框 应 用 需要 首先 创建 警告 对 话 框 对 象 .然后 设置 警告 对 话 框 按钮 .再 显示 
警告 对 话 框 ,最 后 等 待 用 户 单 击 警告 对 话 框 按钮 执行 相应 操作 。 下 面 是 警告 对 话 框 的 
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范例 。 
【 例 3-1】 (代码 位 置 ; \3\testDlg. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”): 


var droid= new Android(); 

droid. dialogCreateAlert (“是 否 提交 ”, “请 选择 单 击 下 面 按钮 ):; 
droid. dialogSetPositiveButtonText (“确定 ); 

droid. dialogSetNeutralButtonText ("取消"); 

droid. dialogSetNegativeButtonText (退出); 

droid. dialogShow() ; 

var obj= droid. dialogGetResponse(); 


// 设 置 对 话 框 标题 内 容 
// 设 置 肯定 按钮 文本 
// 设 置 取消 按钮 文本 
// 设 置 退出 按钮 文本 


switch( obj.which ) 


} 


case “negative”: 
print(“ 单 击 了 退出 按钮 ); 
break; 

case "neutral”: 
print(“ 单 击 了 取消 按钮 ); 
break; 

case “positive”: 
print(“ 单 击 了 确定 按钮 ) ; 
break; 

default: 
break; 


本 例 中 首先 创建 一 个 Android 对 象 ,接着 通过 函数 dialogCreateAlert 创建 了 一 个 
警告 对 话 框 ,并 且 通 过 函数 dialogSetPositiveButtonText 设置 了 一 个 肯定 按钮 文字 ， 
通过 函数 dialogSetNeutralButtonText 设置 了 一 个 中 立 按钮 文字 .通过 函数 
dialogSetNegativeButtonText 设置 了 一 个 否定 按钮 文字 .然后 通过 函数 dialogShow 显示 
该 对 话 框 ,最 后 通过 函数 dialogGetResponse 等 待 用 户 单 击 按钮 ,其 返回 值 是 一 个 对 象 . 
对 象 包括 一 个 which 属性 .which 值 指明 了 用 户 单 击 对 话 框 按钮 选项 。 程 序 运行 后 ,用 户 
可 以 在 手机 屏幕 上 看 到 一 个 警示 对 话 框 .标题 为 “是 否 提交 ”, 内 容 显 示 为 “请 选择 单 击 下 
面 按 钮 ,包含 “确定 “取消 "和 “退出 "三 个 按钮 ,用 户 可 以 单 击 按钮 继续 完成 程序 的 执行 。 


32 ”请求 用 户 输入 信息 和 密码 对 话 框 


用 户 经 常会 接触 到 登录 界面 .用 以 控制 用 户 权 限 、 记 录用 户 行为 .保护 操作 安全 。 登 
录 界 面 一 般 包含 两 个 部 分 : 一 部 分 是 请 求 用 户 输入 信息 的 对 话 框 .如 请 求 用 户 输入 账号 ; 
另 一 部 分 是 请 求 用 户 输入 密码 的 对 话 框 。 

SL4A 中 提供 了 相应 的 函数 创建 请 求 用 户 输入 信息 对 话 框 和 密码 对 话 框 : 
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dialogGetInput( String title, String message, String defaultText) 

该 函数 表示 创建 一 个 对 话 框 ,用 于 请 求 用 户 输入 信息 .参数 title 表示 对 话 框 的 标题 ， 
默认 值 为 "Value” ,参数 message 表示 对 话 框 上 的 提示 信息 .也 就 是 请 求 用 户 输入 信息 , 默 
认 值 为 *Please enter value” ,参数 defaultText 表示 用 户 在 输入 框 内 要 输入 的 内 容 ,这 三 
个 参数 都 是 可 选 的 。 

dialogGetPassword( String title，String message) 

该 函数 表示 创建 一 个 对 话 框 ,用 于 请 求 用 户 输入 密码 ,参数 title 表示 密码 框 的 标题 ， 
默认 值 为 “Password” ,参数 message 是 显示 在 密码 框 上 方 的 提示 信息 ,默认 值 为 *Please 
enter password”, 这 两 个 参数 都 是 可 选 的 。 

下 面 是 登录 的 范例 ,. 例 中 先 请 求 输入 用 户 名 ,然后 请 求 输入 密码 。 

【 例 3-2】 〈 代 码 位 置 : \3\testInputPwdDlg.js) 。 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 


droid. dialogGetInput (“登录 ”,“ 请 输入 用 户 名 :“,““); // 创 建 请 求 用 户 名 输入 对 话 框 
var objl= droid. dialogGetResponse(); 

droid. dialogGetPassword (“登录 ”,“ 请 输入 密码 :”); // 创 建 输入 密码 对 话 框 

var obj2= droid. dialogGetResponse(); 

print (obj1. which); // 用 户 名 对 话 框 按钮 : 确定 或 取消 

print (objl. value); // 用 户 名 对 话 框 的 输入 内 容 

print (obj2. which) ; // 密 码 对 话 框 按钮 : 确定 或 取消 

print (obj2. value) ; // 密 码 值 


本 例 要 设置 一 个 登录 界面 .首先 创建 一 个 Android 对 象 . 接着 通过 函数 
dialogGetInput 创建 一 个 输入 用 户 名 对 话 框 ,用 于 请 求 输 入 用 户 名 ,然后 通过 函数 
dialogGetPassword 创建 一 个 输入 密码 对 话 框 .用 于 请 求 输入 密码 函数 
dialogGetResponse 的 作用 是 等 待 用 户 输入 ,其 返回 值 是 一 个 对 象 , 对 象 包含 which 和 
value 两 个 属性 ,which 值 指 明了 用 户 是 单 击 了 “确定 ”还 是 “取消 "按钮 .value 值 指明 了 用 
户 名 和 密码 值 。 程 序 运 行 后 ,手机 屏幕 上 首先 弹出 一 个 请 求 输入 用 户 名 对 话 框 ,要 求 输入 
用 户 名 。 对 话 框 有 两 个 按钮 .一 个 显示 文本 为 “确定 ”, 另 一 个 显示 文本 为 “取消 ”。 假 设 输 
入 的 用 户 名 为 test, 用 户 可 以 单 击 “ 确 定 ” 或 “取消 "按钮 做 出 选择 ,然后 手机 屏幕 接着 弹出 
一 个 请 求 输入 密码 对 话 框 .要 求 输入 密码 。 


3.3 列 表 
列表 是 按照 一 定 的 线性 顺序 排列 的 数据 选项 的 集合 .用 户 可 以 从 列表 中 选择 需要 的 
选项 .例如 .用 户 长 按 手 机 关机 按钮 时 .屏幕 上 会 弹出 一 个 列表 对 话 框 .标题 是 手机 选项 . 
选项 内 容 为 静音 模式 、 飞 行 模式 、 关 机 .用 户 可 以 从 列表 中 选择 静音 模式 、 飞 行 模式 或 关 
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机 。 列 表 也 呈现 在 警告 对 话 框 的 内 容 区 里 .所 以 创建 列表 需 先 创建 一 个 警告 对 话 框 。 
Android API 提供 了 传统 列表 、 单 选 按 钮 列表 和 多 选 按钮 列表 ( 复 选 框 ) 三 种 列表 .下 面 介 
绍 传统 列表 。 


dialogSetItems( JSONArray items) 


该 函数 用 于 设置 对 话 框 列表 选项 ,通过 传递 一 个 数组 参数 items ,指明 列表 的 选项 , 参 
数 items 的 值 表 示 选 项 的 文本 内 容 ,数组 中 的 每 个 元 素 表示 一 个 选项 。 

下 面 是 列表 的 范例 。 

【 例 3-3】〗 〈 代 码 位 置 :\3NtestItemsDlg. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 


droid. dialogCreateAlert (“列表 ”); 

var items=new Array(); 

items[0]= "选项 1 ; 

items[1]= "选项 2 ; 

items[2]= "选项 3 ; 

items[3]= "选项 4 ; 

droid. dialogSetItems (items) ; // 设 置 一 个 包含 4 个 选项 的 列表 
droid. dialogShow() ; 

var response= droid. dialogGetResponse() ; 

droid. dialogSetItems (nul1) ; 

var item= response. item+ 1; 

droid. dialogCreateAlert (“你 选择 的 列表 项 是 :“, “选项 + item) ; 
droid. dialogSetPositiveButtonText (“确定 ); 

droid. dialogSetNegativeButtonText (退出); 

droid. dialogShow() ; 

droid. dialogGetResponse(); 


本 例 首先 通过 函数 dialogCreateAlert 创建 了 一 个 对 话 框 .标题 为 “列表 ”. 再 在 该 对 
话 框 上 通过 函数 dialogSetItems 设置 了 一 个 列表 . 它 包 含 4 个 列表 选项 .用 数组 items 表 
示 。 选 项 的 值 用 droid. dialogGetResponse 返回 得 到 ,第 一 个 列表 选项 对 应 的 值 是 0. 其 
他 列表 选项 的 值 依 次 递增 。 然 后 创建 了 另 一 个 对 话 框 , 标 题 为 “你 选择 的 列表 项 是 : ”， 
用 来 显示 用 户 选择 的 选项 。 程 序 运行 后 .手机 屏幕 会 弹出 一 个 列表 对 话 框 ,标题 为 “ 列 
表 ”, 它 显示 有 4 个 菜单 选项 .如 图 3-1 所 示 . 用 户 可 以 选择 相应 的 选项 .假如 用 户 选 
择 选项 3 .会 弹出 另 一 个 对 话 框 标题 为 “你 选择 的 列表 项 是 : .显示 用 户 的 选项 是 
“选项 3”。 
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你 选择 的 列表 项 是 





(a) 列表 (b) 显示 用 户 所 选 列表 项 


图 3-1 列表 操作 


3.4 单 选 和 多 选 按钮 


在 单 选 按钮 列表 中 各 选项 是 互 斥 的 ,用户 只 能 从 多 个 选项 中 选择 一 个 。 多 选 按钮 列 
表 ( 复 选 框 ) 表 示 用 户 是 否 需要 某 个 选项 ,用 户 可 以 同时 选择 多 个 选项 中 的 一 个 或 多 个 , 即 
各 选项 间 是 不 互 斥 的 。 

SL4A 中 提供 了 相应 的 函数 创建 单 选 按钮 列表 和 多 选 按钮 列表 : 


dialogSetSingleChoiceItems (JSONArray items，Integer selected) 


该 函数 表示 设置 一 个 单 选 按钮 列表 并 且 选 中 指定 项 ,数组 参数 items 为 列表 的 选项 ， 
它 的 每 个 元 素 表示 一 个 选项 .参数 selected 为 指定 的 选项 .默认 值 为 0. 它 是 可 选项 。 

dialogSetMultiChoiceItems (JSONArray items, JSONArray selected) 

该 函数 表示 设置 一 个 多 选 按钮 列表 并 且 选 中 指定 项 .数组 参数 items 为 列表 的 选项 ， 
参数 selected 为 指定 的 选项 . 它 是 一 个 数组 .表示 可 以 选择 多 个 选项 . 它 是 可 选项 .如 不 设 
置 该 参数 表示 不 设置 指定 选项 

dialogGetSelectedItems () 

该 函数 用 于 得 到 用 户 的 选项 

下 面 通过 实例 分 析 单 选 按钮 和 多 选 按钮 列表 。 

【 例 3-4】 (代码 位 置 : \3\testSingleChoiceDlg. js) 。 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 
droid. dialogCreateAlert(“ 单 选 对 话 框 ?) ; // 设 置 对 话 框 标题 


var items=new Array(); 


items[0]= 选项 1 ; 
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items[1]= "选项 2 ; 

items[2]= "选项 3 ; 

droid. dialogSetSingleChoiceItems (items) ; // 设 置 一 个 包含 三 个 选项 的 单 选 按钮 
droid. dialogSetPositiveButtonText(“ 确 定 “) : 

droid. dialogSetNegativeButtonText ("退出 ); 


droid. dialogShow 0) ; // 显 示 对 话 框 
var ret= droid. dialogGetResponse(); // 等 待 准备 响应 用 户 单 击 选项 等 事件 
ret= droid. dialogGetSelectedItems(); // 获 取 用 户 的 选项 


var choice="”; 
switch ( ret[0] ) 
{ 
case 0: choice=“ 选 项 1”; 
break; 
case 1:choice= “选项 2”; 
break; 
case 2:choice= “选项 3”; 
break; 
default: 
break; 
|! 
droid. dialogCreateAlert (“用 户 选 项 ”, “你 的 选择 项 是 : “+ choice) ; 
droid. dialogSetPositiveButtonText (“确定 ^); 
droid. dialogSetNegativeButtonText (退出); 
droid. dialogShow() ; 


本 例 中 首先 创建 一 个 标题 为 “ 单 选 对 话 框 ” 的 对 话 框 ,再 通过 函数 
dialogSetSingleChoiceItems 在 对 话 框 中 添加 三 个 单 选 按钮 ,默认 指定 第 一 个 选项 为 选中 
项 , 当 用 户 要 改变 选中 项 时 ,通过 函数 dialogGetResponse 响应 用 户 要 选中 的 选项 .并且 
通过 函数 dialogGetSelectedItems 得 到 列表 选项 ,在 单 击 “ 确 定 ” 按 钮 后 .程序 创建 另 一 个 
标题 为 “用 户 选 项 ”的 对 话 框 ,显示 用 户 选 择 的 选项 。 程 序 运行 后 ,屏幕 首先 会 弹出 一 个 列 
表 对 话 框 ,标题 为 “ 单 选 对 话 框 ”, 包 含 三 个 选项 : 选项 1、 选 项 2、 选项 3. 用 户 可 以 单 击 选 
择 其 中 一 项 ,如 图 3-2 所 示 . 假 如 选择 “选项 3”. 单 击 “ 确 定 ” 按 钮 后 ,屏幕 上 弹出 另 一 个 对 
话 框 ,标题 为 “用 户 选项 ”. 显 示 用 户 选 择 的 选项 为 “选项 3”。 

【 例 3-5】 (代码 位 置 : \3\testMultiChoiceDlg. js) 。 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 


droid. dialogCreateAlert ("MultiChoiceIltems”); 
var items= new Array(); 

items[0]= "选项 1 ; 

items[1]= 选项 2 : 
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单 选 对 话 框 


用 户 选 项 





(a) 选择 “选项 3 人 b) 显示 用 户 选择 的 单 选项 


单 选 按钮 


图 





items[2]= "选项 3 ; 

droid. dialogSetMultiChoiceItems (items) ; 
droid. dialogSetPositiveButtonText (“OK”); 
droid. dialogSetNegativeButtonText (“Quit”); 
droid. dialogShow() ; 

var ret= droid. dialogGetResponse() ; 

ret= droid. dialogGetSelectedItems (); 


for( var key in ret) 
{ 


var i=ret[key]+1; 


choice= choice+ “Choiceltem”+i+” 
} 
droid. dialogCreateAlert (“UserChoiceIltems”, “Your Choice:“+ choice) ; 
droid. dialogSetPositiveButtonText (“OK”); 
droid. dialogSetNegativeButtonText ("Quit”); 
droid. dialogShow() ; 


本 例 中 首先 创建 一 个 标题 为 MultiChoiceltems 的 对 话 框 , 再 通过 函数 
dialogSetMultiChoiceItems 在 对 话 框 中 添加 了 包含 三 个 选项 的 多 选 按钮 . 当 用 户 要 改变 
选中 项 时 .通过 函数 dialogGetResponse 响应 用 户 要 选中 的 选项 .并 且 通 过 函数 
dialogGetSelectedItems 得 到 列表 选项 ,在 单 击 OK 按钮 后 .程序 创建 了 另 一 个 标题 为 
UserChoiceltems 的 对 话 框 ,显示 用 户 选择 的 选项 。 程 序 运行 后 .屏幕 首先 会 弹出 一 个 列 
表 对 话 框 .标题 为 MultiChoiceltems. 包 含 三 个 选项 : Choicelteml、Choiceltem2、 
Choiceltem3, 用 户 可 以 单 击 选 择 其 中 一 项 或 多 项 .假如 选择 Choicelteml 和 
Choiceltem3 , 单 击 OK 按钮 后 .屏幕 弹出 另 一 个 对 话 框 .标题 为 UserChoiceltems, 显 示 用 
户 选择 的 选项 为 ChoiceIteml 和 ChoiceItem3 。 运 行 结果 如 图 3-3 所 示 。 
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UserChoiceltems 


Choiceltem1 
Your Choice: Choiceltem1 


Choiceltem2 Choiceltem3 


Choiceltem3 





(a) 用 户 同 时 选中 两 个 选择 项 (b) 显示 用 户 的 多 选项 


图 3-3 多 选 列表 


3.5 时 间 设 置 对 话 框 


用 户 设置 .修改 手机 时 间 时 : 单 击 设 置 时 间 ,屏幕 会 弹出 一 个 时 间 设 置 对 话 框 , 用 户 可 
以 调整 时 钟 分钟. 并 单 击 “ 设 置 "按钮 ,完成 时 间 设 置 。 时 间 对 话 框 是 支持 用 户 选择 时 间 
的 视图 ,可 以 为 24 小 时 制 , 也 可 以 为 AM/PM 制 。 

SL4A 中 提供 了 相应 的 函数 创建 时 间 设 置 对 话 框 : 


dialogCreateTimePicker (Integer hour, Integer minute, Boolean is24hour) 


该 函数 用 于 创建 时 间 设 置 对 话 框 .参数 hour 用 于 设置 时 钟 .默认 值 为 0, 参 数 minute 
用 于 设置 分 钟 . 默 认 值 为 0., 布 尔 参 数 is24hour 表示 时 间 是 否 使 用 24 小 时 制 , 值 为 true 表 
示 使 用 24 小 时 制 ,否则 使 用 12 小 时 制 ,默认 值 为 false. 这 三 个 参数 都 是 可 选 的 。 


dialogDismiss() 


该 函数 用 于 关闭 对 话 框 。 
下 面 是 时 间 设 置 对 话 框 的 范例 
【 例 3-6】〗 (代码 位 置 : \3\testTimePicker. js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 


droid. dialogCreateTimePicker (22, 30) ; 

droid. dialogShow(); 

var ret= droid. dialogGetResponse(); 

droid. dialogDismiss(); 

var hour= ret. hour; 

var minute= ret. minute; 

droid. dialogCreateAlert (“时 间 (时 钟 和 分 钟 )”,““+hour+“:“+minute); 
droid. dialogSetPositiveButtonText (“确定 ): 

droid. dialogSetNegativeButtonText ("退出 “); 

droid. dialogShow() ; 
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droid. dialogGetResponse(); 


droid. dialogDismiss(); 


本 例 中 首先 通过 函数 dialogCreateTimePicker (22,30) 
创建 了 一 个 时 间 设 置 对 话 框 .默认 值 时 钟 为 22. 分 钟 为 30. © 1030PM 
通过 函数 dialogGetResponse 等 待 用 户 设置 时 间 . 并 通过 + 十 
ret. hour 返回 用 户 设置 的 了 时钟,ret. minute 返回 用 户 设置 的 30 | pm | 
分 钟 ,接着 创建 另 一 个 对 话 框 , 用 来 显示 设置 后 的 时 间 。 程 -一 
序 运行 后 屏幕 会 弹出 一 个 时 间 设置 对 话 框 ,显示 时 钟 为 22， 图 < | se | 
分 钟 为 30, 如 图 3-4 所 示 , 用 户 可 以 通过 单 击 时 钟 和 分 钟 上 
的 “十 "和 “一 ”按钮 设置 时 间 , 设 置 后 单 击 Set 按钮 ,屏幕 将 
弹出 另 一 个 对 话 框 显示 用 户 设置 后 的 时 间 。 





图 3-4 时 间 选 择 


3.6 日 期 设置 对 话 框 


用 户 设 置 ,修改 手机 日 期 时 , 单 击 设置 日 期 ,屏幕 会 弹出 一 个 日 期 设置 对 话 框 。 用 户 
可 以 调整 年 .月 .日 ,并 单 击 * 设 置 "按钮 ,完成 日 期 设置 。 日 期 设置 对 话 框 是 向 用 户 提供 包 
含 年 .月 .日 的 日 期 数据 ,并 允许 用 户 对 其 进行 选择 。 

SL4A 中 提供 了 相应 的 函数 创建 日 期 设置 对 话 杠 


dialogCreateDatePicker(Integer year，Integer month，Integer day) 


该 函数 用 于 创建 日 期 设置 对 话 框 , 函 数 含 有 三 个 参数 ,参数 year 用 于 设置 年 .默认 值 
为 1970; 参 数 month 用 于 设置 月 .默认 值 为 1 ;参数 day 用 于 设置 日 .默认 值 为 1. 这 三 个 
参数 都 是 可 选 的 。 

下 面 是 日 期 设置 对 话 框 的 范例 

【 例 3-7】 〈 代 码 位 置 : \3\testDatePicker. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 


droid. dialogCreateDatePicker (2010, 10, 10) ; 

droid. dialogShow() ; 

var ret= droid. dialogGetResponse() ; 

droid. dialogDismiss(); 

var year=ret. year; 

Var month= ret. month; 

var day= ret. day; 

droid. dialogCreateAlert (“Date”, year+ “— “+month+ “一 “+ day) ; 
droid. dialogSetPositiveButtonText (“OK”):; 

droid. dialogSetNegativeButtonText ("Quit”); 
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droid. dialogShow(); 
droid. dialogGetResponse(); 


droid. dialogDismiss(); 


本 例 中 首先 通过 函数 dialogCreateDatePicker 
(2010,10,10) 创 建 了 一 个 日 期 设置 对 话 框 ,初始 日 期 为 


i pe 站 2010 年 10 月 10 日 ,然后 通过 函数 droid- 二 
dialogGetResponse 等 待 用 户 设置 日 期 ,并 通过 ret. year 
返回 用 户 设 置 的 年 ,ret. month 返回 用 户 设 置 的 月 ， 
ret. day 返回 用 户 设置 的 日 .接着 创建 了 另 一 个 对 话 


| ss js | 图 框 ,用 来 显示 年 .月 .日 。 程序 运行 后 屏幕 会 弹出 一 
个 日 期 设置 对 话 框 .如 图 3.5 所 示 , 用户 可 以 通过 日 
期 上 下 的 “十 "和 “一 "按钮 设置 调整 年 .月 .日 ,设置 
后 , 单 击 Set 按钮 ,屏幕 将 弹出 另 一 个 对 话 框 显示 用 户 设置 后 的 日 期 。 


3.7 水 平 进度 条 


用 户 在 下 载 文件 时 ,会 弹出 一 个 水 平 进度 条 对 话 框 , 显 示 文 件 下 载 的 进度 。 通常 ,用 
户 在 上 传 、 下 载 大 文件 或 大 量 文件 时 .需要 一 定时 间 才 能 完成 任务 ,这 时 用 户 希 望 知道 任 
务 完成 的 进度 情况 .在 SL4A 中 可 以 通过 带 有 进度 指示 器 的 水 平 进度 条 用 来 显示 任务 的 
进度 位 置 、 任 务 的 完成 情况 。 

下 面 介绍 创建 水 平 进度 条 对 话 框 和 设置 水 平 进度 条 指示 器 位 置 的 相关 函数 。 


(©) Sunday, Octobe 





图 3-5 设置 日 期 


dialogCreateHorizontalProgress (String title，String message，Integer maximum) 

该 函数 用 于 创建 水 平 进度 条 对 话 框 ,参数 title 表示 对 话 框 标题 ,参数 message 表示 
对 话 框 中 显示 的 内 容 . 参 数 maximum 表示 进度 条 的 最 大 值 .默认 值 是 100, 这 三 个 参数 都 
是 可 选 的 。 

dialogSetCurrentProgress (Integer current) 


该 函数 用 于 设置 水 平 进 条 度 的 当前 进度 值 . 参 数 current 表示 当前 值 .其 值 范围 在 零 
和 maximum 之 间 。 


dialogDismiss () 

该 函数 用 于 关闭 对 话 框 。 

下 面 是 水 平 进度 条 的 范例 。 

【 例 3-8〗 〈 代 码 位 置 :\3\testHProgressDlg.js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 
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droid. dialogCreateHorizontalProgress(“ProgressBarTitle“,“Please Wait...”):; 
droid. dialogShow 0) ; 
for (var items=0; items<=100; items++) 

droid. dialogSetCurrentProgress (items) ; 


droid. dialogDismiss() ; 


本 例 中 首先 通过 函数 dialogCreateHorizontalProgress 创建 了 一 个 水 平 进度 条 对 话 

框 ,标题 为 ProgressBarTitle, 然后 通过 函数 dialogSetCurrentProgress 设置 进度 条 当前 

值 , 当 前 值 会 逐渐 变 大 .从 0 直至 100, 进 度 值 达到 最 大 100 后 ,通过 函数 dialogDismiss 关 

闭 对 话 框 。 程 序 运行 后 ,屏幕 将 会 弹出 一 个 水 平 进度 条 对 话 框 ,对话 框 中 的 进度 条 从 左 向 
会 不 断 前 进 , 当 进度 值 到 达 最 右边 时 ,进度 条 对 话 框 将 消失 ,说 明 任务 已 经 完成 。 


3.8 搜索 进度 条 


用 户 在 播放 音乐 的 时 候 .会 弹出 一 个 搜索 进度 条 ,该 进度 条 不 仅 显 示 了 音乐 播放 的 进 
度 , 用 户 还 可 以 拖 动 指示 器 改变 播放 的 进度 ,内容 。 通 常用 户 在 播放 音乐 ,电影 .视频 时 ， 
除了 想 要 知道 当前 播放 的 进度 ,还 需要 多 久 能 播 完 .并且 用 户 经 常 想 要 拖 动 指示 器 改变 播 
放任 务 的 进度 。 水 平 进度 条 实现 了 显示 任务 的 进度 ,但 是 用 户 不 可 以 手工 拖 动 进度 指示 
器 改变 任务 的 进度 ,在 SL4A 中 可 以 通过 创建 一 个 搜索 进度 条 实现 这 样 的 功能 。 搜 索 进 
度 条 和 水 平 进度 条 外 观 上 相同 .但 是 搜索 进度 条 可 以 让 用 户 拖 动 进度 指示 器 改变 任务 的 
进度 。 

dialogCreateSeekBar (Integer starting, Integer maximum, String title, String message) 


该 函数 用 来 创建 一 个 搜索 进度 条 ,参数 starting 表示 进度 条 当前 值 .默认 值 为 50, 参 
数 maximum 表示 进度 条 最 大 值 ,默认 值 为 100 ,参数 title 表示 搜索 进度 条 对 话 框 标题 , 参 
数 message 表示 对 话 框 显示 信息 。 

下 面 是 搜索 进度 条 的 范例 。 

【 例 3-9】 (代码 位 置 : \3\testSeekBar. js) 。 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”):; 
var droid= new Android(); 


droid. dialogCreateSeekBar (20, 100, “搜索 进度 条 对 话 框 ”, “搜索 条 对 话 框 显示 信息 “); 
droid. dialogSetPositiveButtonText (是); 

droid. dialogSetNegativeButtonText (” 否 ); 

droid. dialogShow() ; 

var ret= droid. dialogGetResponse(); 

droid. dialogDismiss(); 


var msg= ret. progress; 
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droid. dialogCreateAlert(“ 搜 索 条 值 为 :“,”“*+msg) ; 
droid. dialogSetPositiveButtonText (是); 

droid. dialogSetNegativeButtonText (" 否 ); 

droid. dialogShow(); 


droid. dialogGetResponse(); 


本 例 中 通过 函数 dialogCreateSeekBar 创建 了 一 个 搜索 进度 条 对 话 框 ,标题 为 “搜索 
进度 条 对 话 框 ”", 当 前 值 为 20, 通 过 函数 dialogGetResponse 等 待 用 户 拖 动 进 度 条 ,然后 创 
建 另 一 个 对 话 框 , 显 示 用 户 拖 动 后 的 搜索 值 。 程 序 运行 后 .屏幕 弹出 一 个 搜索 进度 条 对 话 
框 , 进 度 条 中 有 一 个 水 平滑 动 条 ,用户 可 以 单 击 滑动 条 自行 设置 滑动 条 的 滑动 位 置 , 如 
图 3-6 所 示 . 其 中 .图 3-6(a) 是 用 户 设置 的 进度 值 .图 3-6(b) 用 来 显示 设置 的 进度 值 , 显 示 
设置 的 值 为 80 。 


搜索 进度 条 对 话 要 搜索 条 值 为 : 


二 话 框 显示 信息 





(a) 设置 搜索 进度 条 值 (b) 显示 搜索 进度 条 进度 值 


图 3-6 ”搜索 进度 条 


39 等 待 完成 进度 条 


用 户 在 使 用 双 卡 手机 :切换 网 络 时 ,屏幕 会 弹出 一 个 带 旋转 圆圈 的 等 待 完成 进度 条 对 
话 框 ,提示 正在 连接 网 络 .请 用 户 等 待 。 类 似 这 种 应 用 ,应 用 程序 连接 网 络 、 装 载 资源 时 ， 
需要 时 间 完 成 任务 ,用户 需要 等 待 .但 等 待 时 间 是 不 确定 的 .在 SL4A 中 提供 了 一 个 带 有 
旋转 圆圈 的 等 待 完 成 进度 条 .用 来 提示 用 户 系统 正在 加 载 数 据 .避免 用 户 感觉 应 用 已 经 
“死机 ”, 旋 转 的 圆圈 表示 有 任务 在 进行 中 .但 完成 的 时 间 不 确定 。 


dialogCreateSpinnerProgress (String title，String message，Integer maximum) 

该 函数 用 来 创建 等 待 完 成 进度 条 ,参数 title 表示 对 话 框 标题 ,参数 message 表示 进 
度 条 的 显示 内 容 .参数 maximum 表示 进度 值 .默认 值 为 100. 这 三 个 参数 都 是 可 选 的 。 

下 面 是 等 待 完成 进度 条 的 范例 。 

【 例 3-10】 〈 代 码 位 置 : \3\testSpinnerProgress. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 


droid. dialogCreateSpinnerProgress(“ 网 络 连接 ,正在 连接 中 , 请 耐心 等 待 .…) ; 
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本 例 中 首先 通过 函数 dialogCreateSpinnerProgress 创建 了 一 个 等 待 完成 进度 条 . 标 
题 为 "网络 连接 ”, 然 后 经 过 5s 的 等 待 后 ,调用 函数 dialogDismiss 使 对 话 框 消失 。 程 序 运 
行 后 ,屏幕 会 弹出 一 个 带 有 旋转 圆圈 的 等 待 完成 进度 条 对 话 框 ,表示 系统 正在 连接 网 络 ， 
用 户 等 待 5s 后 该 进度 条 自动 消失 。 
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由 于 基于 对 话 框 的 用 户 界面 不 能 全 屏 显 示 用 户 界面 .其 代码 和 用 户 界面 相 混 淆 不 具 
有 好 的 设计 特点 等 不 足 , 因 此 基于 对 话 框 的 用 户 界 面 只 适合 简单 的 应 用 。SL4A 提供 的 
FullScreeenUI 可 以 让 应 用 程序 全 屏 显 示 用 户 界面 ,允许 使 用 XML 描述 用 户 界 面 ,可 以 
很 灵活 地 在 用 户 界面 中 添加 控件 ,设置 控件 外 观 ,控制 控件 的 组 织 结构 ;可 以 让 代码 和 用 
户 界 面相 分 离 , 降 低 彼 此 之 间 的 耦合 度 。 总 之 ,这 种 方法 的 优点 是 可 以 实现 复杂 的 全 屏 界 
面 、 灵 活性 强 、 占 用 资源 小 ,并 且 具 有 较 好 的 扩展 性 。 本 章 主 要 介绍 FullScreenUI 设计 实 
现 用 户 界面 ,要 使 用 FullScreenUI 实现 用 户 界面 ,需要 先 掌握 几 个 比较 重要 的 函数 ,这 些 
函数 的 主要 作用 是 解析 XML 文件 全 屏 显 示 用 户 界面 ,动态 查询 用 户 界面 属性 值 .修改 控 
件 属 性 动态 更 新 用 户 界面 外 观 . 覆 盖 和 自 定义 键盘 按键 功能 。 

fullShow (String layout: String containing View layout, String title [optional]: Activity 

Title) 

该 函数 的 作用 是 全 屏 显示 用 户 界面 .参数 layout 是 用 户 界 面 描述 串 .该 描述 串 用 
XML 描述 .参数 title 表示 活动 的 标题 ,该 参数 可 选 。 


fullDismiss() 
该 函数 用 来 隐藏 当前 用 户 界面 。 
fullQueryO 


该 函数 用 来 查询 用 户 界 面 控件 属性 集 。 返 回 值 是 一 个 对 象 (为 方便 区 别 ,此 处 称 为 A 
对 象 ) .该 对 象 的 每 个 属性 对 应 一 个 控件 .属性 名 和 控件 id 标识 符 值 相同 .属性 的 数据 类 
型 是 对 象 (B 对 象 ). 这 个 对 象 (B 对 象 ) 的 属性 对 应 控件 的 属性 。 如 果 没 有 为 控件 定义 id， 
则 此 方法 不 会 返回 该 控件 的 属性 集 。 


fullQueryDetail (String id) 


该 函数 用 来 查询 指定 控件 的 属性 .参数 id 表示 控件 标识 符 . 函 数 返回 值 是 对 象 . 对 象 
的 属性 即 为 控件 属性 。 


fullSetProperty (String id, String property, String value) 
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该 函数 用 来 设置 控件 属性 和 属性 值 . 参 数 id 表示 控件 标识 符 ,参数 property 表示 控 
件 的 属性 名 ,参数 value 表示 属性 值 。 


fullSetList(String id, JSONArray list) 


该 函数 用 来 设置 列表 等 控件 的 列表 项 .参数 id 表示 列表 等 控件 的 标识 符 , 参数 list 
表示 列表 项 .可 用 数组 来 表示 。 


fullKeyOverride (JSONArray keycodes, Boolean enable) 


该 函数 用 来 覆盖 键盘 事件 ,可 用 来 改变 系统 的 默认 按键 行为 .参数 keycodes 表示 要 
被 覆盖 的 按键 值 集 .可 用 数组 来 表示 .参数 enable 是 布尔 类 型 变量 ,用 来 表示 是 否 打开 或 
关闭 默认 按键 行为 . 值 true 表示 关闭 按键 默认 行为 . 值 false 表示 打开 按键 默认 行为 ,该 
参数 可 选 , 默 认 值 是 true, 函 数 将 返回 原先 设置 的 键 值 集 。 

在 Android 界面 中 会 有 很 多 控件 .如 文本 控件 .按钮 控件 .图 片 控 件 等 .这 些 控件 需要 
被 控制 位 置 、 大 小 和 排列 顺序 .Android 界面 可 以 通过 布局 方便 地 实现 这 些 目 的 。 界 面 布 
局 是 指 界面 内 容 的 组 织 结构 .控件 是 用 户 界面 的 主要 内 容 之 一 .布局 决定 了 控件 之 间 的 结 
构 。 设计 Android 界面 布局 和 HTML 框架 界面 很 相似 ,主要 做 两 件 事情 ,首先 要 给 
Android 应 用 界面 定 框架 .也 就 是 安排 好 被 添加 控件 的 组 织 结构 和 顺序 ,然后 再 在 框架 里 
面 放 控件 ,设置 控件 的 属性 。 

Android 提供 了 两 种 实现 布局 的 方法 ,一 种 是 通过 代码 控制 .实现 界面 布局 ,也 就 是 
所 有 的 组 件 都 通过 new 关键 字 创 建 出 来 ,然后 将 这 些 组 件 添加 到 布局 管理 器 中 ,从 而 实 
现 用 户 界 面 , 这 种 方法 能 够 动态 地 改变 界面 :比较 灵活 ,但 是 开发 过 程 比较 烦琐 。 另 一 种 
是 使 用 XML 描述 布局 ,使 布局 界面 的 代码 和 控制 逻辑 的 代码 分 离开 来 .使 程序 的 结构 更 
加 清晰 .明了 .具有 实现 方便 、 快 捷 , 维 护 简 toview 
便 等 优点 ,但 是 XML 描述 布局 适用 于 静态 
界面 , 它 不 能 动态 改变 界面 。 

SL4A 支持 XML 描述 布局 ,下 面 通过 
例 4-1 来 说 明 如 何 使 用 XML 描述 用 户 界 Ee 
面 ,这 是 一 个 登录 界面 .如 图 4-1 所 示 . 在 这 | Button 
个 界面 中 包含 TextView( 文 本 显示 控件 ) 、 
EditText( 文 本 编辑 控件 ) 和 Button( 按 钮 图 4-1 XML 描述 的 登录 界面 
控件 ) 等 。 

怎么 安排 和 组 织 这 些 控件 在 界面 中 的 位 置 、 大 小 和 排列 顺序 昵 ? 这 就 需要 对 界面 进 
行 布局 管理 。 在 本 例 中 .首先 使 用 了 一 个 垂直 线性 布局 .在 该 布局 中 以 垂直 排列 的 方向 从 
上 到 下 依次 添加 了 第 一 个 水 平 线性 布局 .第 二 个 水 平 线性 布局 和 一 个 Button 控件 。 在 第 
一 个 水 平 线性 布局 中 从 左 到 右 依次 添加 了 一 个 TextView 和 一 个 EditText, 同 样 .在 第 二 
个 水 平 线性 布局 中 从 左 到 右 依次 添加 了 一 个 TextView 和 一 个 EditText。 

本 例 由 两 个 文件 组 成 .一 个 是 XML 文件 mylayout. xml. 用 于 描述 界面 布局 ; 另 一 个 
是 JavaScript 文件 test. js. 用 于 读 取 mylayout. xml 用 户 界 面 文件 并 把 用 户 界 面 显示 
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出 来 。 
【 例 4-1】 (代码 位 置 : \4\login) 
文件 mylayout. xml: 





文件 test. js: 
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在 文件 mylayout. xml 中 . 先 添加 了 一 个 垂直 线性 布局 .通过 属性 android: 
orientation 一 "vertical "说明 该 线性 布局 中 添加 的 子 元 素 ( 两 个 水 平 线性 布局 和 一 个 
Button 控件 为 垂直 方向 排列 。 然 后 在 该 垂直 线性 布局 中 添加 了 第 一 个 子 元 素 , 该 子 元 
素 为 一 个 水 平 线性 布局 ,在 该 水 平 线性 布局 中 添加 了 一 个 文本 显示 控件 .文本 显示 内 容 为 
“用 户 名 :”. 添 加 了 一 个 文本 编辑 控件 ,用 来 输入 编辑 用 户 名 。 接 着 在 该 垂直 线性 布局 中 
添加 了 第 二 个 子 元 素 , 该 子 元 素 为 一 个 水 平 线性 布局 ,在 该 水 平 线性 布局 中 添加 了 一 个 文 
本 显示 控件 ,文本 显示 内 容 为 “密码 :”. 添 加 了 一 个 文本 编辑 控件 .用 来 输入 编辑 密码 。 
最 后 ,在 垂直 线性 布局 中 添加 了 一 个 按钮 控件 。 

程序 运行 前 ,可 以 在 PC 端 通过 DDMS 或 360 手机 助手 等 工具 把 文件 mylayout. xml 
和 文件 test. js 复制 到 手机 或 模拟 器 的 /sdcard/sl4a/scripts 目录 ,然后 在 移动 设备 端 单 击 
SL4A 图 标 ,打开 SL4A 管理 器 ,通过 SL4A 管理 器 单 击 文件 列表 中 的 test. js 文件 ,运行 
文件 test. js。 运 行 结果 如 图 4-1 所 示 。 

结合 例 4-1, 在 使 用 XML 描述 布局 时 ,需要 理解 以 下 事项 。 

(1) XML 描述 全 屏 用 户 界面 的 文件 其 扩展 名 必须 是 “. xml”, 如 例 4-1 中 文件 名 为 
“mylayout. xml”。 

(2) XML 的 根 节点 通常 是 一 个 根 布局 , 根 布局 里 可 以 放置 任意 控件 或 子 布局 节点 ， 
如 例 4-1 中 根 节点 是 垂直 线性 布局 , 根 节 点 的 子 元 素 有 两 个 水 平 线性 布局 
(LinearLayout) 和 一 个 按钮 控件 (Button) .在 每 个 水 平 线性 布局 中 分 别 包 含 一 个 文本 控 
件 (Text View) 和 一 个 文本 编辑 控件 (EditText) 。 

(3) 布局 文件 的 根 节点 必须 包含 值 为 “http://schemas. android. com/apk/res/ 
android” 的 命名 空间 .命名 空间 可 以 避免 不 同 XML 文件 元 素 的 命名 冲突 ,也 有 标识 控件 
的 作用 。 

(4) 系统 通过 控件 的 属性 id 唯一 识别 该 控件 ,在 XML 代码 中 创建 控件 时 ,可 以 给 控 
件 的 属性 id 定义 一 个 值 。 一 个 新 id 的 定义 格式 为 "@ 十 id/myId”。 如 例 4-1 中 ,添加 一 
个 Button 控件 时 ,通过 android:id 二 "@ 十 id/button1" 给 该 控件 定义 id 为 “buttonl”。 

(5) 一 个 应 用 用 户 界面 的 实现 需要 依赖 一 个 XML 和 一 个 脚本 文件 .XML 文件 用 来 
描述 用 户 界面 .脚本 用 来 解析 XML 文件 和 全 屏 显 示 用 户 界面 ,以 及 响应 控件 事件 和 处 理 
具体 业务 。 

(6) 布局 中 的 子 元 素 和 控件 包含 很 多 属性 .通过 这 些 属 性 可 以 设置 子 元 素 和 控件 的 
颜色 .大 小 外 观 和 显示 的 文字 等 。 

控件 的 背景 通过 属性 background 设置 .Android 支持 24 位 RGB 颜色 和 包含 透明 度 
的 24 位 RGB 颜色 ,背景 颜色 的 属性 值 可 以 使 用 十 六 进 制 数 来 表示 。 对 于 包含 透明 度 的 
24 位 RGB 颜色 .前 面 两 位 十 六 进 制 数 表示 透明 度 . 值 越 小 越 透明 . 值 越 大 越 不 透明 。 例 


如 ,Android: background 王 "ff0000" 表 示 背 景 颜 色 是 红色 , Android: background 一 
" 革 80ff0000" 表 示 背 景 是 半 透 明 的 红色 .Android: background 王 "#ffff0000" 表 示 背 景 是 


不 透明 的 红色 。 如 例 4-1 中 .通过 属性 android:background 二 "000000" 设 置 布局 背景 
颜色 为 黑色 。 
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控件 中 要 显示 的 文字 通过 属性 text 设置 . 如 例 4-1 中 .添加 按钮 控件 .通过 属性 
android:text 一 "登录 "定义 按钮 控件 显示 的 文本 内 容 是 “登录 ”。 

控件 的 大 小 和 位 置 通常 通过 属性 layout_width( 宽 度 ) 和 layout_height( 高 度 ) 来 控 
制 ,一般 会 有 三 个 对 应 的 属性 值 wrap_content fill_parent 和 match_parent。wrap_ 
content 是 让 控件 根据 自己 的 内 容 来 定义 大 小 , 即 控件 内 容 有 多 少 ,控件 就 有 多 大 ;fill 
parent 和 match_parent 都 是 让 控件 充满 父 控件 ,在 例 4-1 中 ,设置 按钮 控件 宽度 、 高 度 时 ， 
通过 android:layout_width 二 "wrap_content" android:layout_beight 王 "wrap_content" 设 
置 宽度 和 高 度 是 根据 自己 的 内 容 来 定义 大 小 。 

控件 的 大 小 和 位 置 还 可 以 用 数值 任意 指定 ,设置 宽 高 等 距离 时 必须 有 单位 ,如 例 4-1 
中 ,通过 android:layout_width 王 "80dp" 指 定 第 一 个 文本 控件 的 宽度 ,单位 说 明 如 表 4-1 
所 示 。 




















表 4-1 单位 符号 表 
单位 符号 单位 名 称 说 明 
mm 毫米 与 日 常生 活 中 说 的 毫米 一 样 ,物理 意义 
in 英寸 与 日 常生 活 中 说 的 英寸 一 样 ,物理 意义 
pt 点 (point) lpt 二 1/72 英寸 ,物理 意义 
px 像素 (pixel) 即 屏幕 的 实际 像素 
dip 设备 独立 像素 使 显示 的 大 小 与 屏幕 密度 无 关 
sp 比例 像素 与 dp 类 似 ,主要 用 于 文字 的 显示 








(7) 布局 中 常 需要 控制 子 元 素 之 间 的 排列 关系 和 位 置 关系 , 子 元 素 与 父 元 素 之 间 的 
对 齐 方式 和 位 置 关系 ,各 元 素 和 控件 包含 相应 的 属性 来 实现 位 置 关 系 和 对 齐 方式 。 例 如 ， 
控件 的 排列 取向 由 属性 orientation 来 控制 ,属性 值 vertical 表示 垂直 取向 布局 ,属性 值 
horizontal 表示 水 平 取向 布局 .默认 值 为 vertical。 如 例 4-1 中 ,描述 一 个 线性 布局 时 通过 
属性 android:orientation 一 "vertical "确定 在 该 线性 布局 中 添加 的 子 元 素 ( 两 个 水 平 线性 
布局 和 一 个 Button 控件 ) 为 垂直 方向 排列 。 

在 界面 布局 时 .经 常用 到 android: gravity 和 android:layout_gravity 两 个 属性 ,它们 
都 用 于 对 齐 ,android: gravity 用 于 设置 该 控件 中 的 内 容 相 对 于 该 控件 的 对 齐 方式 ,而 
android:layout_gravity 用 于 设置 该 控件 本 身 相 对 于 父 控件 的 对 齐 方式 。 例 如 ,对 于 一 个 
按钮 .属性 android: gravity 表示 按钮 上 的 文字 在 按钮 上 的 位 置 、 对 齐 方式 ,而 属性 
android:layout_gravity 表示 该 按钮 在 界面 上 的 位 置 、 对 齐 方式 ,这 两 个 属性 可 取 的 属性 
值 及 含义 如 表 4-2 所 示 : 默 认 值 为 left, 这 些 属性 值 可 以 同时 指定 .各 属性 值 之 间 用 “|” 
隔 开 。 

在 界面 布局 时 .常会 用 到 属性 android:layout_margin 和 android:padding. 它 们 的 含 
义 如 表 4-3 和 表 4-4 所 示 。 
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表 4-2 android:gravity 和 android:layout_gravity 属性 值 和 含义 














属性 值 二 ” 义 
top 将 控件 放 在 顶部 ,不 改变 其 大 小 
bottom 将 控件 放 在 底部 ,不 改变 其 大 小 
left 将 控件 放 在 左 侧 ,不 改变 其 大 小 
right 将 控件 放 在 右 侧 .不 改变 其 大 小 





center_vertical 


将 控件 纵向 居中 ,不 改变 其 大 小 (垂直 方向 上 居中 对 齐 ) 





center _horizontal 


将 控件 水 平 居 中 ,不 改变 其 大 小 (水 平方 向 上 居中 对 齐 ) 





center 


将 控件 横 纵向 居中 ,不 改变 其 大 小 





fill_vertical 


必要 时 将 控件 纵向 拉 伸 ,以 完全 填充 (垂直 方向 填充 ) 





filL_horizontal 


必要 时 将 控件 横向 拉 伸 ,以 完全 填充 (水 平方 向 填充 ) 





fi 


必要 时 将 控件 横向 纵向 拉 伸 ,以 完全 填充 





表 4-3 属性 android:layout_margin 的 含义 


属 性 


含义 





android:layout_margin 


该 控件 距离 父 控件 的 边 距 ,例如 ,android:layout_margin 一 "20dip" 表 
示 该 控件 上 下 左右 距离 父 控件 的 距离 都 是 20dip 





android:layout_marginLeft 


该 控件 左 侧 距离 父 控件 的 距离 ,例如 .android: layout_marginLeft- 
"20dip" 表 示 该 控件 左 侧 距 离 父 控件 的 距离 是 20dip 





android :layout_marginRight 


该 控件 右 侧 距离 父 控件 的 距离 .例如 .android: layout_marginRight 
二 "20dip" 表 示 该 控件 右 侧 距 离 父 控件 的 距离 是 20dip 





android:layout_marginTop 


该 控件 顶部 距离 父 控件 的 距离 ,例如 ,android:layout_marginTop 一 
"20dip" 表 示 该 控件 顶部 距离 父 控件 的 距离 是 20dip 





android:layout_marginBottom 


属 性 


该 控件 底部 距离 父 控件 的 距离 .例如 ,android:1layout_marginBottom 一 
"20dip" 表 示 该 控件 底部 距离 父 控件 的 距离 是 20dip 


表 4-4 属性 android:padding 的 含义 
富 : 忽 





android:padding 


控件 中 的 内 容 ( 如 文本 或 图 片 ) 距 离 该 控件 的 边 距 ,例如 .android: 
padding 一 "10dip" 表 示 控 件 中 的 内 容 上 下 左右 距离 该 控件 10dip 





android:paddingLeft 


控件 中 的 内 容 左边 距离 该 控件 的 边 距 ,例如 .android:paddingLeft 一 
"10dip" 表 示 控 件 中 的 内 容 左边 距离 该 控件 10dip 





android:paddingRight 


控件 中 的 内 容 右 边 距 离 该 控件 的 边 距 , 例 如 ,android: paddingRight 
一 "10dip" 表 示 控 件 中 的 内 容 右 边 距离 该 控件 10dip 





android: padding Top 


控件 中 的 内 容 顶 部 距离 该 控件 的 边 距 .例如 ,android: paddingTop 一 
"10dip" 表 示 控 件 中 的 内 容 顶 部 距离 该 控件 10dip 





android: paddingBottom 





控件 中 的 内 容 底 部 距离 该 控件 的 边 距 .例如 .android: paddingBottom 一 
"10dip" 表 示 控 件 中 的 内 容 底部 距离 该 控件 10dip 
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Android 系统 提供 了 LinearLayout (线性 布局 )、FrameLayout ( 帧 布局 )、 
AbsoluteLayout( 绝 对 布局 )、RelativeLayout( 相 对 布局 ) 和 TableLayout( 表 格 布局 ) , 下 
面 将 逐一 介绍 。 


42 LineatLayout 布 局 


LinearLayout 也 称 线性 布局 , 线性 布局 由 标签 LinearLayout 定义 ,根据 属性 
android:orientation 所 取 的 值 .线性 布局 分 为 垂直 线性 布局 和 水 平 线性 布局 。 当 android: 
orientation 一 "vertical "时 ,描述 的 是 垂直 线性 布局 . 它 是 单列 多 行 结构 ,每 行 只 能 放置 一 
个 控件 ,控件 依照 从 顶 行 到 底 行 顺序 放置 ; 当 android:orientation 一 "horizontal" 时 ,描述 
的 是 水 平 线性 布局 , 它 是 单行 多 列 结构 .每 列 只 能 放置 一 个 控件 ,控件 依照 从 左 列 到 右 列 
顺序 放置 。 如 图 4-2 所 示 ,. 图 4-2(a) 是 一 个 垂直 线性 布局 ,有 三 个 控件 ,分 别 是 Button]l、 
Button2,Button3 ,依次 从 顶 行 到 底 行 顺 序 放置 ;图 4-2(b) 是 一 个 水 平 线 性 布局 ,有 三 个 控 
件 , 分 别 是 Buttonl1 .Button2 .Button3 ,依次 从 左 到 右 顺 序 放置 





(a) 垂直 线性 布局 (b) 水 平 线性 布局 
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布局 是 可 以 谋 套 的 ,也 就 是 布局 里 可 以 含有 布局 ,例如 ,要 搭建 两 行 两 列 的 布局 ,首先 
描述 垂直 线性 布局 ,垂直 排列 两 个 元 素 .然后 .每 一 个 元 素 里 再 包含 一 个 水 平 线性 布局 . 进 
行 水 平 排列 。 

LinearLayout 中 的 子 元 素 还 有 一 个 重要 的 属性 android:layout_weight, 该 属性 会 给 
子 元 素 分 配 一 个 权重 值 .用 于 描述 该 子 元 素 在 剩余 空间 中 占有 的 大 小 比例 ,属性 值 越 小 其 
重要 度 越 高 .显示 所 占 的 剩余 空间 越 大 。 例如. 如果 一 行 只 有 一 个 文本 框 ,那么 它 的 属性 
值 默 认为 0; 如果 一 行 中 有 两 个 文本 框 .它们 的 android:layout_weight 值 都 是 1. 说 明 这 
两 个 文本 框 长 度 相 等 ;如 果 一 行 中 有 两 个 文本 框 .它们 的 android:layout_weight 值 分 别 
为 1 和 2, 说 明 第 一 个 文本 框 将 占据 剩余 空间 的 三 分 之 二 .第 二 个 文本 框 将 占据 剩余 空间 
中 的 三 分 之 一 。 

下 面 通过 例 4-2 来 说 明 线性 布局 。 本 例 要 描述 一 个 嵌 套 线性 布局 ,首先 使 用 了 一 个 
垂直 线性 布局 .然后 在 布局 中 包含 一 个 文本 控件 和 谋 套 了 一 个 水 平 线性 布局 ,在 水 平 线性 
布局 中 又 包含 两 个 控件 。 本 例 由 两 个 文件 组 成 .一 个 是 XML 布局 文件 mylayout. xml, 用 
于 描述 界面 布局 ; 另 一 个 是 JavaScript 文件 test. js. 用 于 读 取 XML 布局 文件 并 把 界面 显 
示 出 来 。 
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【 例 4-2〗 〈 代 码 位 置 : \4\linearlayout)。 
文件 mylayout. xml: 
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文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xm1”); 
droid. fullShow (layout); 
droid. eventWait (10000) ; 
function file get contents(fileName) { 
var file=new java. io.File(fileName) ; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
Var tempString=null; 


var fileString="”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


} 


在 文件 mylayout. xml 中 . 先 描 述 垂直 线性 布局 ,然后 在 垂直 线性 布局 中 添加 一 个 文 
本 控件 (TextView) ,文本 内 容 为 “线性 布局 测试 .再 在 垂直 线性 布局 中 嵌 套 了 一 个 水 平 
线性 布局 .水 平 线性 布局 又 包含 两 个 控件 .第 一 个 文本 内 容 为 “文本 控件 1”, 通 过 属性 
android:layout_weight 一 "2" ,表示 它 占据 水 平 线性 布局 三 分 之 一 空间 .第 二 个 文本 内 容 
为 “文本 控件 2”, 通 过 属性 android:1layout_weight 二 "1" ,表示 它 占据 水 平 线性 布局 三 分 
之 二 空间 。 

文件 test. js 中 的 函数 file_get_contents 用 于 读 取 文件 并 返回 文件 内 容 ,参数 
fileName 为 文件 名 。 脚 本 运行 时 首先 创建 Android 对 象 . 然 后 调用 函数 file_get_contents 
读 取 用 户 界 面 文 件 /sdcard/sl4a/scripts/mylayout. xml, 最 后 调用 函数 fullShow 
($1layout) 显 示 用 户 界 面 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
sdcard/sl4a/scripts/ 目录. 然后 再 通过 SL4A 管理 器 单 击 文件 列表 中 的 test. js 文件. 运 
行文 件 test. js. 屏 幕 会 出 现 一 个 界面 .其 显示 效果 是 : 界面 垂直 排列 有 两 行 .第 一 行 显示 
文本 内 容 为 “线性 布局 测试 ”. 第 二 行 水 平 排列 两 个 控件 .第 一 个 控件 显示 文本 为 “文本 控 
件 1”, 占 据 第 二 行 三 分 之 一 空间 .第 二 个 控件 显示 文本 为 “文本 控件 2”, 占 据 第 二 行 三 分 
之 二 空间 。 运 行 结果 如 图 4-3 所 示 。 








图 4-3 ”LinearLayout 布局 


69 


Andioid 脚本 应 用 开县 技术 


4.3 ”Fram eLayout 布 局 


FrameLayout 是 帧 布局 .也 称 框架 布局 .是 Android 布局 中 最 简单 的 一 个 布局 。 在 这 
个 布局 中 ,在 屏幕 上 开辟 出 了 一 块 区 域 .在 这 块 区 域 中 可 以 添加 多 个 子 控件 ,所 有 的 子 控 
件 都 被 对 齐 到 父 元 素 左 上 角 . 帧 布局 的 大 小 由 子 控件 中 尺寸 最 大 的 那个 子 控件 来 决定 。 
所 有 的 子 控件 以 层 芭 的 方式 放置 在 这 个 区 域 中 ,第 一 个 添加 的 控件 放 在 最 底层 ,最 后 添加 
的 放 在 最 上 面 ; 下 面 的 控件 将 被 上 面 的 控件 覆盖 。 

下 面 通过 例 4-3 来 说 明 帧 布局 。 本 例 首先 使 用 了 一 个 帧 布局 .再 在 布局 上 依次 添加 
三 个 文本 控件 (TextView) ,它们 都 被 对 齐 到 帧 布局 左上 角 ,第 一 个 文本 控件 放 在 最 底层 ， 
第 二 个 文本 控件 又 加 在 第 一 个 文本 控件 上 .第 三 个 文本 控件 以 侄 加 的 方式 放 在 最 上 面 。 
本 例 包 含 两 个 文件 .一 个 是 XML 布局 文件 mylayout. xml, 用 于 描述 帧 布局 ; 另 一 个 是 
JavaScript 文件 test. js, 用 于 读 取 XML 布局 文件 并 把 界面 显示 出 来 。 

【 例 4-3〗 〈 代 码 位 置 : \4\framelayout) 

文件 mylayout. xml: 


《2?xml version= "1.0”encoding= utf-8"?>《“!--xml 的 版 本 及 编码 方式 --> 
“FrameLayout xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout_width= “fill_parent” 
android:layout_height= “fill_parent” 
>《 !-- 描 述 一 个 帧 布局 -> 
《TextView 
android:layout width=“fill parent” 
android:layout_height= “fill parent” 
android:background= “#000000” 
android:gravity= center” 
android:text= 第 一 个 文本 控件 
/>《“!-- 在 帧 布局 中 添加 第 一 个 文本 控件 --> 
《TextView 
android:layout_width= “200dp ” 
android:layout_height= “200dp“ 
android:background= “#FF0000” 
android:gravity= center” 
android:text=“ 第 二 个 文本 控件 ” 
/2《 !-- 在 帧 布局 中 添加 第 二 个 文本 控件 -一 > 
< TextView 
android:layout_width= “80dp” 
android:layout_ height=“80dp” 
android:background= “#336666” 
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android:gravity= “center” 
android:text= “第 三 个 文本 控件 
/>《 !-- 在 帧 布局 中 添加 第 三 个 文本 控件 --> 


《/FrameLayout> 


文件 test. js: 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xml”); 
droid. fullShow (layout); 

droid. eventWait (10000) ; 

function file get _contents (fileName) { 


var file=new java. io.File(fileName); 


var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 


var tempString=null; 


var fileString="”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader.readLine()) !=null) { 
fileString=fileString+tempString ; 
} 
reader. close() ; 


return fileString; 


在 文件 mylayout. xml 中 , 先 描述 了 一 个 帧 布局 ， 
再 在 该 布局 中 添加 了 第 一 个 文本 控件 (TextView). 并 
设置 宽度 和 高 度 为 充满 父 控件 ,文本 内 容 android :text 
为 “第 一 个 文本 控件 ”。 然 后 在 该 布局 中 添加 了 第 二 个 
文本 控件 .设置 宽度 (layout_width) 和 高 度 (layout 
height) 都 是 200dp, 文 本 内 容 android: text 为 “第 二 个 
文本 控件 ”"。 最 后 在 该 布局 中 添加 了 第 三 个 文本 控件 ， 
设置 宽度 (layout_width) 和 高 度 (layout_height) 都 是 
50dp, 文 本 内 容 为 “第 三 个 文本 控件 ” 

程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 
test. js 复制 到 手机 或 模拟 器 中 的 /sdcard/sl4a 
scripts/ 目 录 . 然 后 再 通过 SL4A 管理 器 单 击 文件 列表 
中 的 test. js 文件 .运行 test. js, 运行 结果 如 图 4-4 
所 示 。 Ey 
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图 4-4 FrameLayout 布局 
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44 AbsobhteLayout 布 局 


AbsoluteLayonut 也 称 绝 对 布局 .在 此 布局 中 .以 屏幕 左上 和 角 为 坐标 原点 (0.0) ,第 一 
个 0 代表 横 坐 标 , 向 右 移 动 此 值 增 大 :第 二 个 0 代表 纵 坐标 .向 下 移动 此 值 增 大 。 所 有 的 
子 元 素 通过 设置 属性 android: layout_x 和 android: 
layout_y 将 子 元 素 的 坐标 位 置 国 定 下 来 , 即 坐 标 
(Candroid:layout_x，android:layout_y) ,layout_x 用 来 
表示 横 坐 标 . layout_y 用 来 表示 纵 坐 标 。 在 此 布局 中 
的 子 元 素 可 以 相互 重合。 例如 ,图 4-5 是 一 个 绝对 布 
局 .该 布局 中 有 两 个 控件 ,控件 以 屏幕 左上 角 为 坐标 原 


ey 点 (0,0), 将 Buttonl 的 坐标 设置 为 (50,50),Button2 
Es 的 坐标 设置 为 (150,150) ,根据 设置 的 坐标 精确 确定 这 
两 个 控件 在 界面 中 的 位 置 。 





在 实际 开发 中 .通常 不 推荐 采用 此 布局 格式 ,因为 
图 4-5 ”AbsoluteLayout 布局 不 同 的 设备 屏幕 的 大 小 ,分辨 率 各 不 相同 ,使 用 绝对 布 
局 很 难保 证 应 用 的 通用 性 ,在 不 同 的 设备 上 运行 其 效 

果 会 不 理想 ,甚至 有 可 能 不 能 很 好 地 适 配 各 种 终端 。 


45 RekativeLayout 布 局 


RelativeLayout 也 称 相对 布局 , RelativeLayout 按照 各 子 元 素 之 间 的 位 置 关 系 完 成 
布局 ,允许 子 元 素 指定 它们 相对 于 其 父 元 素 或 兄弟 元 素 的 位 置 . 它 是 实际 布局 中 最 常 
用 的 布局 方式 之 一 ,是 Android 布局 结构 中 最 灵活 的 一 种 布局 结构 .适合 一 些 复 杂 界 面 
的 布局 。 

描述 相对 布局 界面 时 . 子 元 素 里 与 位 置 相 关 的 属性 将 生效 。 子 元 素 使 用 这 些 位 置 属 
性 时 需要 指定 被 参照 的 控件 ,这些 属 性 值 的 格式 都 为 "@id/idname”。 注 意 在 指定 位 置 关 
系 时 ,引用 的 ID 必须 在 引用 之 前 先 被 定义 .否则 将 出 现 异 常 。 为 了 便于 理解 和 掌握 ,下 面 
分 三 组 介绍 RelativeLayout 常用 的 位 置 属性 。 

(1) 表 4-5 中 属性 用 于 设置 控件 之 间 的 位 置 关 系 和 对 齐 方 式 ; 

(2) 表 4-6 中 属性 用 于 设置 控件 与 父 控件 之 间 的 对 齐 方式 ; 

(3) 表 4-7 中 属性 用 于 设置 控件 的 方向 。 

下 面 通过 例 4-4 说 明 相 对 布局 .本 例 首先 描述 了 一 个 相对 布局 ,依次 在 布局 上 添加 了 
三 个 文本 控件 .第 一 个 控件 与 父 组 件 的 底部 对 齐 . 第 二 个 控件 位 于 第 一 个 控件 的 上 方 ,并 
且 第 三 个 控件 位 于 第 二 个 控件 的 左 方 。 本 例 包 含 两 个 文件 .一 个 是 XML 布局 文件 
mylayout. xml, 用 于 描述 帧 布局 ; 另 一 个 是 JavaScript 文件 test. js。 
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表 4-5 相对 布局 中 控件 之 间 位 置 关 系 和 对 齐 方式 的 属性 及 说 明 





























属 性 属性 说 明 备 注 

android :layout_above 将 该 控件 放置 于 给 定 ID 控件 的 上 面 

android:layout_below 将 该 控件 放置 于 给 定 ID 控件 的 下 面 

android :layout_toLeftOf 将 该 控件 放置 于 给 定 ID 控件 的 左边 属性 值 为 某 个 控件 
android:layout_toRightOf ”| 将 该 控件 放置 于 给 定 ID 控件 的 右边 a 
android:layout_alignTop ”| 将 该 控件 的 顶部 与 给 定 控件 的 顶部 对 齐 Shore A Ne 
android:layout_alignBottom | 将 该 控件 的 底部 与 给 定 控件 的 底部 对 齐 全 人 0 
android: layout_alignLeft 将 该 控件 的 左边 边缘 与 给 定 控件 的 左边 边缘 对 齐 
android:layout_alignRight 齐 





表 4-6 相对 布局 中 控件 与 父 控件 之 间 对 齐 方式 的 属性 及 说 明 


将 该 控件 的 右边 边缘 与 给 定 控件 的 右边 边缘 对 
































属 性 属性 说 明 备 注 
android: layout_alignParentTop | 是 否 将 该 控件 的 顶部 与 父 控件 的 顶部 对 齐 
android: layout_alignParentBottom | 是 否 将 该 控件 的 底部 与 父 控件 的 底部 对 齐 属性 值 为 true， 表 
android: layout_alignParentLeft i ds 
. E . 是 否 将 该 控件 的 右边 边缘 与 父 控件 的 右边 边 
android: layout_alignParentRight 
缘 对 齐 
表 4-7 相对 布局 中 控件 方向 的 属性 及 说 明 
属 性 属性 说 明 备 注 
android :layout_centerInParent 是 否 将 该 控件 相对 于 父 控件 居中 
属性 值 为 true 或 false， 
android :layout_center Horizontal 是 否 将 该 控件 水 平 居中 为 true 表示 成 立 ,为 
false 表示 不 成 立 
android:layout_centerVertical 是 否 将 该 控件 垂直 居中 
【 例 4-4】 (代码 位 置 ; \4\relativelayout) 


文件 mylayout. xml: 


< ?xml] version=“1.0” encoding= “utf— 8”?> 


<RelativeLayout 


xmlns:android= “http://schemas. android. com/apk/res/android” 


android:orientation= “vertical” 
android:background= “#000000” 
android:layout width= “fill parent” 


android:layout_ height= “fill parent” 
>《 !-- 描 述 一 个 相对 布局 -一 > 
< TextView 


3 | 
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文件 test.js: 
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var file=new java. io.File (fileName):; 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“”; 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close () ; 
return fileString; 


} 


在 文件 mylayout. xml 中 ,通过 RelativeLayout 标签 定义 了 一 个 相对 布局 ,然后 在 
布局 中 添加 了 第 一 个 文本 控件 ,定义 了 它 的 ID 为 “text_01”, 文 本 内 容 为 “TextView 
1" ,通过 android: layout_alignParentBottom 二 "true" 设 置 它 的 底部 与 相对 布局 的 底部 
对 齐 。 

接着 添加 了 第 二 个 文本 控件 ,定义 了 它 的 ID 为 “text_02”, 文 本 内 容 为 *TextView 2” 
通过 android:layout_above 二 "(@id/text_01" 设 置 它 放 置 在 第 一 个 控件 (id 为 text_01) 的 
上 面 ,通过 android:layout_centerHorizontal 二 "true" 设 置 该 控件 水 平 居 中 ,。 

最 后 添加 了 第 三 个 文本 控件 ,定义 了 它 的 ID 为 "texL03”, 文 本 内 容 为 "TextView3”， 
通过 android:layout_toLeftOf 二 "@id/text_02" 设置 该 控件 放置 在 第 二 个 控件 (id 为 
textL02) 左 边 , 通 过 android:layout_above 一 "@id/text_01" 设 置 它 放置 在 第 一 个 控件 
(id 为 text_01) 的 上 面 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 

sdcard/sl4a/ scripts/ 目 录 . 然 后 再 通过 SL4A 管理 器 单 击 文件 列表 中 的 test. js 文件 , 运 
行 test.js, 屏 幕 会 出 现 一 个 界面 .其 显示 效果 是 : 第 一 个 控件 显示 文本 内 容 TextView 1， 
它 与 父 组 件 的 底部 对 齐 , 第 二 个 控件 显示 文本 内 容 TextView 2, 它 位 于 第 一 个 控件 的 上 
方 .水平 居中 ,第 三 个 控件 显示 文本 内 容 TextView 3, 它 位 于 第 二 个 控件 的 左 方 .第 一 个 
控件 的 上 方 。 运 行 结果 如 图 4-6 所 示 





图 4-6 RelativeLayout 布局 
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46 TabkLayout 布 局 


TableLayout 也 称 表格 布局 .顾名思义 .就 是 以 表格 的 形式 来 排列 控件 .把 控件 放 在 
表格 的 单元 格 中 ,但 表格 布局 中 并 不 会 为 每 一 行 、 每 一 列 或 每 个 单元 格 绘制 边框 。 表 格 布 
局 中 通过 属性 TableRow 来 定义 行 .每 个 表格 可 以 有 多 个 
TableRow ,一 个 TableRow 代表 一 行 .布局 中 有 多 少 个 
TableRow 就 代表 表格 布局 有 多 少 行 。TableLayout 的 列 
数 等 于 含有 最 多 子 控件 的 TableRow 的 列 数 , 如 图 4-7 所 
示 . 这 是 一 个 表格 布局 .在 这 个 表格 布局 中 ,第 一 个 
TableRow 有 两 个 控件 ,第 二 个 TableRow 有 三 个 控件 (是 

图 4-7 表格 布局 该 布局 含有 控件 最 多 的 TableRow) ,第 三 个 TableRow 有 

一 个 控件 ,那么 该 布局 就 有 三 列 。 控 件 可 以 根据 需要 放置 

到 指定 列 中 ,控件 也 可 以 占用 多 列 。 表 格 中 的 单元 格 可 以 为 空 , 也 就 是 说 没有 放置 任何 
控件 。 

表格 布局 中 可 以 设置 布局 属性 和 单元 格 属性 。 下 面 介 绍 表格 布局 常用 属性 和 单元 格 
属性 ,如 表 4-8 所 示 。 





表 4-8 表格 布局 和 单元 格 属性 





属 性 说 明 
将 控件 放置 到 指定 列 位 置 , 列 的 开始 位 置 从 0 开始 计算 ,例如 ,android: 
anadroidilayout colunin layout_column 一 "0" 表示 该 控件 显示 在 第 0 列 ,android:layout_column 


一 "2" 表示 该 控件 显示 在 第 二 列 


设置 控件 占据 的 列 数 , 如 未 指定 该 属性 则 默认 占 一 列 , 例 如 ,android: 
layout_span 一 "2" 表 示 该 控件 占据 两 列 





android: layout_span 





android: collapseColumns 设置 要 隐藏 的 列 .例如 .android:collapseColumns"3" 将 第 三 列 隐 藏 





设置 可 收缩 的 列 。 当 该 列子 控件 的 内 容 太 多 ,已 经 挤 满 所 在 行 ,那么 该 
android: shrinkColumns 子 控件 的 内 容 将 往 列 方向 显示 ,例如 ,android: shrinkColumns"1" 表 示 
第 一 列 设置 为 可 收缩 

设置 可 伸展 的 列 。 该 列 可 以 向 行 方向 伸展 .最 多 可 占据 一 整 行 ,例如 ， 
android:stretchColumns"0" 表 示 第 0 列 设置 为 可 伸展 





android: stretchColumns 








下 面 通过 例 4-5 说 明 表 格 布局 .本 例 首先 描述 了 一 个 表格 布局 ,该 布局 为 三 行 三 列表 
格 ,第 一 行 包 含 两 个 控件 .其 中 有 一 个 控件 占有 两 个 单元 格 ;第 二 行 含有 两 个 控件 .其 中 第 
一 个 控件 被 指定 放置 到 了 第 一 列 , 第 二 个 控件 会 顺序 被 放置 到 第 二 列 , 第 0 列 没有 控件 ; 
第 三 行 有 三 个 控件 。 本 例 包 含 两 个 文件 .一 个 是 XML 布局 文件 mylayout. xml, 用 于 描述 
帧 布局 ; 另 一 个 是 JavaScript 文件 test. js。 

【 例 4-5】 (代码 位 置 : \4\tablelayout) 

文件 mylayout. xml: 
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文件 test. js: 
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var reader=new java. io.BufferedReader (new java. io.FileReader (file)); 


var tempString=null; 


var fileString= 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
reader. close(); 
return fileString; 


} 


在 文件 mylayout. xml 中 ,首先 通过 TableLayout 标签 定义 了 一 个 表格 布局 ,然后 在 
该 布局 中 添加 第 一 个 TableRow (描述 第 一 行 ). 在 第 一 行 ,添加 了 两 个 文本 控件 
(TextView), 第 一 个 文本 控件 放置 在 第 0 列 ,第 二 个 文本 控件 通过 android:layout_span 
一 "2" 被 设置 占有 两 个 单元 格 . 也 就 是 把 它 放置 在 了 第 一 、 二 列 。 接 着 在 该 布局 中 添加 第 
二 行 ,在 第 二 行 中 .添加 了 两 个 文本 控件 .第 一 个 文本 控件 通过 属性 android:layout_ 
column 一 "1" 被 放置 在 第 一 列 , 然 后 顺序 添加 了 第 二 个 文本 控件 ,也 就 是 把 它 放置 在 了 第 
二 列 。 最 后 在 该 布局 中 添加 第 三 行 .在 第 三 行 添加 了 三 个 文本 控件 .它们 从 左 到 右 依次 顺 
序 放置 。 

程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目录, 然后 再 通过 SL4A 管理 器 单 击 文件 列表 中 的 test. js 文件 , 运 
行 test.js, 屏 幕 会 出 现 一 个 界面 .其 显示 效果 是 : 出 现 一 个 三 行 三 列 的 表格 结构 ,第 一 行 
包含 两 个 控件 .文本 内 容 为 “test10" 的 控件 占有 其 中 第 0 列 , 文 本 内 容 为 “test11” 的 控件 
占有 第 一 、 二 列 ;第 二 行 含有 两 个 控件 .其 中 文本 内 容 为 test21” 的 控件 被 指定 放置 到 了 
第 一 列 , 文 本 内 容 为 “test22” 的 控件 顺序 被 放置 到 第 二 列 . 第 0 列 没有 控件 ;第 三 行 有 三 
个 控件 。 运 行 结果 如 图 4-8 所 示 。 
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Widget 也 称 微 件 .其 最 初 的 概念 是 1998 年 一 个 叫 Rose 的 苹果 计算 机 工程 师 提 出 
的 .直到 2003 年 Widget 在 苹果 操作 系统 上 以 小 工具 形式 出 现 的 时 候 才 正式 为 人 们 所 知 ， 
随后 无 数 大 公司 都 开始 接受 并 应 用 这 一 思路 。Widget 实际 上 是 一 个 小 型 的 应 用 程式 , 它 
可 以 是 一 个 时 钟 .一 个 日 记 簿 .一 段 视频 .天 气 预 报 .一 个 Flash 游戏 等 小 程序 。 简 单 地 
说 ,Widget 可 以 理解 为 “应 用 小 插件 ”一 种 可 供用 户 制 作 和 自由 下 载 的 小 工具 , 它 包 含 娱 
乐 .工作 和 学 习 等 多 种 实用 功能 。 目 前 的 Widget 应 用 大 体 可 分 为 三 种 : Desktop 
Widget、Web Widget 以 及 Mobile Widget。Desktop Widget 可 以 在 计算 机 桌面 上 独立 执 
行 ,用 户 无 须 通过 浏览 器 便 可 连接 到 网 络 。 时 至 今日 .很 多 人 已 对 苹果 、 雅 虎 .Google 及 
微软 开发 的 Desktop Widget 比较 熟悉 。 通 过 这 些小 型 应 用 软件 .用 户 可 把 各 类 网 上 信息 
(如 天 气 .新 闻 头 条 、 图 片 等 ) 放 到 桌面 上 。Mobile Widget 实际 上 是 运行 在 移动 设备 上 的 
Desktop Widget。 

为 了 提高 开发 效率 .Android 系统 提供 有 标准 的 开发 类 Widget. 这 类 Widget 就 是 开 
发 中 常用 的 控件 。 虽 然 控 件 是 一 个 拥有 一 定 功 能 的 Widget' 但 控件 不 能 独立 运行 , 它 需 
要 髓 到 应 用 程序 中 才 可 以 运行 。 控 件 是 对 数据 和 方法 的 封装 ,控件 可 以 有 自己 的 属性 和 
方法 ,属性 是 控件 数据 的 简单 访问 者 ,方法 是 控件 一 些 可 见 的 功能 。 控 件 是 Android 用 户 
界面 中 重要 的 组 成 元 素 之 一 .主要 包括 文本 框 \ 按 钮 , 单 选 按钮 .多 选 按钮 等 ,能 够 实现 人 
机 交互 ,如 显示 文本 、 输 入 编辑 文本 、 选 择 选项 等 。 


5.1 Text jew 


TextView 控件 用 来 向 用 户 显示 一 行 或 多 行 的 文本 或 者 标签 . 它 是 不 可 编辑 的 。 
TextView 控件 中 包含 很 多 属性 .如 文本 的 颜色 和 大 小 等 属性 ,在 XML 文件 中 可 以 对 
属性 设置 相应 的 属性 值 . 以 达到 相应 的 效果 。TextView 控件 常用 属性 如 表 5-1 
所 示 。 

下 面 通过 例 5-1 说 明 TextView 控件 。 本 例 首先 描述 了 一 个 线性 布局 .然后 在 布局 
中 添加 了 一 个 TextView 控件 .用 来 显示 文本 。 本 例 由 两 个 文件 组 成 .一 个 是 用 户 界面 
XML 文件 mylayout. xml, 另 一 个 是 JavaScript 文件 test. js。 


第 5 这 hndroid Widget 


表 5-1 TextView 常用 属性 和 说 明 





























属 性 说 明 
android:gravity 设置 控件 中 文字 对 齐 方向 ,其 值 为 left、center 和 right 
android:height 设置 控件 高 度 
android: width 设置 控件 宽度 
android:hint 当 控 件 显示 内 容 为 空 时 显示 的 文本 ( 即 提示 信息 ) 
android:textColorHint | 设置 提示 信息 文字 的 颜色 ,默认 为 灰色 ,与 hint 一 起 使 用 
android :text 设置 控件 上 的 文本 内 容 
android:textColor 设置 文本 颜色 
android :textSize 设置 文本 字体 大 小 
Sr 设置 文本 字体 , Android 系统 默认 支持 三 种 字体 ,分 别 为 : sans, serif， 


monospace, 除 此 之 外 还 可 以 使 用 其 他 字体 文件 ( x . ttf) 





android: 


background 设置 控件 背景 颜色 





设置 字体 为 粗 体 和 斜体 , 取 值 为 bold( 粗 体 ) 和 italic( 斜 体 ) , 值 可 以 组 合 , 组 合 








android:textStyle 时 值 之 间 要 加 | 符号 ,例如 ,android: textStyle 一 "boldlitalic" 表 示 文 本 为 粗 
斜体 
android:lines 设置 文本 的 行 数 ,设置 两 行 就 显示 两 行 ,即使 第 二 行 没有 数据 
当 文 本 为 URL 链接 /email/ 电 话 号 码 /map 时 ,设置 是 否 文本 显示 为 可 单 击 
android:autoLink 





的 链接 。 可 选 值 有 none/web/email/phone/map/all 


【 例 5-1】 〈 代 码 位 置 : \5\textview) 
文件 mylayout. xml: 


“9?xml version=“1.0” encoding= “utf— 8”?> 
<LinearLayout 


xmlns:android= “http://schemas. android. com/apk/res/android” 


android:orientation= “vertical” 


android:layout width= “fill parent” 


android:layout_height= “fill parent” 
>《 !-- 描 述 一 个 线性 布局 -一 > 


《TextView 


android:text= "这 是 TextView 控件 ,用 来 显示 文本 , 文字 居中 对 齐 . 
android:layout width=“wrap_content” 

android:layout_height= “wrap_content” 
android:textSize=“25px”< !--- 设 置 文本 字体 大 小 -一 > 
android:textColor=“#fff00000”< !-- 设 置 文本 颜色 --》> 
android:background= “#00ff00”《< !-- 设 置 控件 背景 颜色 --》> 
android:textStyle=“bold”< !-- 设 置 字体 为 粗 体 -一 > 
android:gravity= “center” 

android:height= “200px” 
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/>《< !-- 在 线性 布局 中 添加 一 个 TextView 控件 -一 > 
< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xm1”); 
droid. fullShow (layout); 

droid. eventWait (10000) ; 


function file_ get contents(fileName) { 
var file=new java. io.File (fileName); 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 


var fileString= 
// 一 次 读 入 一 行 , 直到 读 入 null 时 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


i 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 ,然后 在 该 布局 中 通过 
TextView 标签 添加 了 一 个 文本 显示 控件 ,通过 属性 android:text 设置 文本 显示 内 容 为 
“这 是 TextView 控件 .用 来 显示 文本 ,文字 居中 对 齐 .”. 通 过 属性 android:textSize 设置 
文本 字体 大 小 为 “25px”. 通过 属性 android: textColor 设置 文本 字体 颜色 ,通过 属性 
android:textStyle 设置 文本 字体 为 粗 体 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目录 ,然后 再 运行 test. js, 这 时 屏幕 上 会 出 现 一 个 文本 控件 ,显示 文 
本 内 容 为 “这 是 TextView 控件 .用 来 显示 文本 .文字 居中 对 齐 。”。 
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用 户 使 用 手机 编辑 发 送信 息 时 .屏幕 上 会 出 现 一 个 文本 编辑 框 , 用 来 输入 编辑 信息 。 
文本 编辑 框 控件 也 就 是 EditText 控件 . 它 是 可 编辑 的 文本 控件 ,用 户 可 以 在 该 控件 中 编 
辑 要 输入 的 内 容 . 然 后 该 控件 接收 用 户 的 输入 .并 把 用 户 的 输入 传输 给 Android 应 用 处 
理 .实现 人 机 交互 。EditText 控件 是 Android 应 用 中 非常 重要 的 控件 ,应 用 非常 广泛 。 
例如 ,用 户 在 登录 QQ 时 .需要 通过 密码 编辑 框 输入 密码 ;用 户 在 拨打 电话 时 .需要 通过 文 
本 编辑 框 输入 电话 号 码 等 。 
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用 户 使 用 EditText 控件 时 .输入 的 文本 内 容 可 以 是 单行 文本 ,也 可 以 是 多 行文 本 .可 
以 是 不 同 的 类 型 .如 数字 、 文 字 、 时 间 日 期 邮箱 地 址 、 密 码 等 ,这 时 控件 的 属性 android: 
inputType 显得 尤其 重要 .在 XML 文件 中 可 以 通过 设置 属性 android:inputType 的 属性 
值 ,指定 EditText 控件 接收 相应 类 型 的 文本 .同时 ,EditText 控件 还 会 让 虚拟 键盘 来 适应 
输入 框 中 内 容 的 类 型 。 属 性 android:inputType 的 值 及 含义 说 明 如 表 5-2 所 示 。 


表 5-2 android:inputType 值 及 含义 




















属性 值 含义 (文本 类 型 ) 属性 值 含义 (文本 类 型 ) 
text 任何 文本 textPassword 密码 输入 
number 数字 datetime 时 间 日 期 
numberDecimal 带 小 数 点 的 数字 time 时 间 
phone 电话 号 码 date 日 期 
textEmailAddress 邮箱 地 址 格式 textMultiLine 多 行 输入 
textUri 网 址 singleLine 单行 输入 











下 面 通过 实例 5-2 描述 了 EditText 控件 。 该 例 中 通过 属性 android:inputType 一 


"text" 设 置 该 控件 可 接受 任何 文本 .没有 格式 类 型 约束 。 本 例 包 含 两 个 文件 ,一 个 是 
XML 布局 文件 mylayout. xml; 另 一 个 是 PHP 文件 test. php。 


【 例 5-2】 (代码 位 置 : \5\edittext) 
文件 mylayout. xml: 


《?xml version=“1.0” encoding= utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_height= “fill parent” 
android:background=“#ff000000” 
android:gravity= “center” 
>《 !-- 描 述 一 个 线性 布局 -一 > 
<EditText 
android:layout width=“wrap_content” 
android:layout_height= “wrap_content” 
android:textSize= “20px” 
android:inputType= “text” 
/2 《1!--- 在 线性 布局 中 添加 一 个 文本 编辑 控件 -一 > 
< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”):; 
var droid= new Android(); 
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var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xm1”); 
droid. fullShow (layout); 
droid. eventWait (10000) ; 


function file get contents(fileName) { 
var file=new java. io.File(fileName):; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“"; 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close(); 
return fileString; 


程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. php 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/ scripts/ 目录 ,然后 再 运行 test. js, 这 时 屏幕 上 会 出 现 一 个 文本 编辑 框 ,用 户 
可 以 在 该 编辑 框 中 输入 任何 文本 。 

用 户 登录 时 ,经 常 被 要 求 在 密码 框 中 输入 文本 ,这 时 ,密码 框 将 不 显示 文本 内 容 而 是 
用 点 表示 文本 内 容 。 实 例 5-3 描述 了 一 个 密码 框 控件 ,该 例 中 通过 属性 android: 
inputType 一 "textPassword "设置 该 控件 输入 文本 的 格式 为 密码 输入 。 程 序 运行 后 ,屏幕 
上 会 出 现 一 个 密码 输入 框 ,用 户 可 以 在 该 编辑 框 中 输入 密码 。 

【 例 5-3】 (代码 位 置 : \5\pwdtext) 

文件 mylayout. xml: 


< ?xml version= “1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_height= “fill parent” 
android:background=“#ff000000” 
android:gravity= “center” 
><!-- 描 述 一 个 线性 布局 -一 > 
《EditText 
android:layout width= “wrap_content” 
android:layout_height=“wrap_content” 
android:textSize= ”20px” 
android:inputType= “textPassword” 
/>》《 !- -在 线性 布局 中 添加 一 个 密码 框 控件 --> 
< /LinearLayout> 
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文件 test. php: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xml1”); 
droid. fullShow (layout); 

droid. eventWait (10000) ; 


function file get contents(fileName) { 
var file=new java. io.File(fileName); 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“"; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


用 户 在 输入 文本 时 ,如 果 文本 内 容 较 多 .文本 框 一 行 输 满 后 ,用 户 希 望 换行 接着 输入 
文本 ,这 时 需要 多 行文 本 框 。 例 5-4 描述 了 一 个 多 行文 本 框 控 件 ,该 例 中 通过 属性 
android:inputType 二 "textMultiLine "设置 该 控件 可 以 多 行 输 入 文本 . 当 文 本 框 一 行文 本 
输 满 时 会 自动 换行 ,文本 框 也 接受 回 车 换行 符 。 程 序 运 行 后 ,屏幕 上 会 出 现 一 个 多 行文 本 
框 , 用 户 可 以 在 该 文本 框 中 进行 多 行 输入 文本 .。 

【 例 5-4】 (代码 位 置 ; \5\multilinetext) 

文件 mylayout. xml: 


< ?xml version= “1.0” encoding= “utf— 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_height= “fill parent” 
android:background=“#ff000000” 
android:gravity= “center” 
>< !-- 描 述 一 个 线性 布局 -一 > 
<EditText 
android:layout width= “wrap_content” 
android:layout_height= “wrap_content” 
:textSize=“20px” 
android:inputType= ”textMultiLine” 
/>< !-- 在 线性 布局 中 添加 一 个 多 行文 本 框 --> 
“/LinearLayout> 





androi 
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文件 test.js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js“) ; 
var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xm1”); 
droid. fullShow (layout); 

droid. eventWait (10000) ; 


function file get_contents (fileName) { 
var file=new java. io.File(fileName) ; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


} 


用 户 拨打 电话 ,在 文本 框 中 输入 信息 时 .为 了 避免 误 输入 ,希望 系统 只 提供 拨打 电话 
时 所 涉及 的 符号 ,这 时 需要 电话 格式 的 文本 框 。 在 文本 框 中 输入 信息 时 ,系统 会 弹出 软 键 
盘 供 用 户 输 入 . 软 键盘 只 提供 拨打 电话 时 所 涉及 的 符号 。 需 要 指出 的 是 ,还 有 其 他 格式 的 
文本 框 也 会 提供 软 键盘 ,但 系统 会 根据 格式 提供 不 同 的 软 键盘 .例如 .textUri 和 Date 格 
式 的 文本 框 会 提供 网 址 和 日 期 格式 的 软 键盘 。 

实例 5-5 描述 了 一 个 电话 格式 文本 框 控 件 .用 来 输入 电话 号 码 . 该 例 中 通过 属性 
android:inputType 王 "phone" 设 置 该 控件 为 电话 格式 文本 框 。 程 序 运 行 后 .屏幕 会 出 现 
一 个 软 键盘 ,这 个 软 键盘 只 提供 拨打 电话 时 所 涉及 的 符号 ,用户 可 以 在 编辑 框 中 输入 电话 
号 码 。 

【 例 S-5】 (代码 位 置 : \5\phonetext) 

文件 mylayout. xml: 


“9?xml version= "1.0” encoding= “utf- 8”?> 

<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout _ height= “fill parent” 
android:background=“#ff000000” 
android:gravity= “center” 

>《!-- 描 述 一 个 线性 布局 -一 > 

<EditText 
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android:layout width= “wrap_content” 
android:layout height= “wrap_content” 
android:textSize= “20px” 
android:inputType= “phone” 
android: text= “987654321” 
/>《 !-- 在 线性 布局 中 添加 一 个 电话 格式 文本 框 -一 > 
</LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get_ contents(”/sdcard/sl4a/scripts/mylayout. xml”); 
droid. fullShow (layout); 

droid. eventWait (10000) ; 


function file get_contents (fileName) { 
var file=new java. io.File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 


var fileString="”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 


return fileString; 


5.3 Buton 


用 户 在 进行 登录 时 .界面 上 会 有 一 个 含有 文本 “登录 ”的 Button 控件 . 单 击 该 控件 后 
可 以 实现 登录 。Button 是 按钮 控件 .是 Android 界面 中 最 常用 的 控件 之 一 .用 户 可 以 单 
击 它 产生 事件 .实现 各 种 操作 .例如 .可 以 点 击 按钮 实现 信息 的 确认 等 操作 。 添 加 Button 
控件 时 .需要 给 按钮 控件 定义 一 个 ID 号 .并 且 可 以 通过 控件 相应 的 属性 值 来 设置 控件 的 
大 小 、 颜 色 、 文 本 的 内 容 、 字 体 等 。 

下 面 通过 例 5-6 说 明 Button 控件 。 本 例 首先 描述 了 一 个 线性 布局 .然后 在 布局 中 添 
加 了 一 个 Button 控件 。 

【 例 5-6】 (代码 位 置 ; \5\button) 

文件 mylayout. xml: 
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文件 test. js: 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 通过 
Button 标签 添加 了 一 个 按钮 控件 .文本 内 容 为 “ 单 击 按钮 ”id 为 "mybutton ”。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目 录 . 然 后 再 运行 test. js, 屏 幕 上 会 出 现 一 个 按钮 ,显示 文本 为 “ 单 
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击 按钮 ”。 


54 和 ageButon 


ImageButton 控件 是 图 片 按钮 控件 ,是 Android 提供 的 另 一 种 按钮 控件 ,与 Button 
控件 不 同 的 是 .ImageButton 控件 可 以 在 按钮 上 加 载 一 个 图 片 .从 而 控件 上 显示 的 是 图 
片 。ImageButton 控件 能 实现 自 定义 风格 .使 按钮 外 观 更 美观 。 

Android 界面 中 .ImageButton 可 以 引用 图 像 资 源 .字符 串 和 图 标 等 不 同类 型 的 资源 ， 
引用 资源 的 格式 如 下 。 


@ 包 名 :资源 类 型 /资源 名 


ImageButton 以 文件 URL 的 形式 引用 图 片 资源 ,支持 的 图 像 文 件 格式 是 png 和 jpg 
格式 。 

ImageButton 引用 图 片 的 来 源 . 可 以 是 自 定义 的 图 片 文 件 资 源 , 也 可 以 是 Android 系 
统 提供 的 标准 图 片 资源 ,这 些 标准 资源 是 所 有 应 用 程序 共享 的 ,关于 可 用 系统 资源 的 完整 
列表 ,请 参阅 http://developer. android. com/reference/android/R. html。 

ImageButton 可 以 通过 android:src 属性 来 定义 引用 的 图 片 , 它 有 两 种 定义 格式 , 具 
体 如 表 5-3 所 示 。 

表 5-3 android:sre 格式 及 含义 


格 式 含义 
引用 系统 提供 的 标准 图 片 资源 ,例如 ,android: src 一 
"@android:drawable/stat_sys_phone_callL on_hold" 


引用 图 像 文 件 资源 , 例如 , android: src 一 "file:/// 


sdcard/download/panda72. png” 





android:src 一 "@android:drawable/ 资 源 名 ” 





android:src 一 " file:/// 目 录 和 文件 名 " 





下 面 通过 实例 说 明 ImageButton 控件 。 该 按钮 上 显示 的 图 片 引 用 了 系统 提供 的 标准 
图 片 资 源 。 

【 例 5-7】 (代码 位 置 : \5\imagebutton1) 

文件 mylayout. xml: 


< ?xml] version= “1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout _ height= “fill parent” 
android:background= “#000000” 
>< !-- 描 述 一 个 线性 布局 -一 > 
< ImageButton 
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android:layout width=“wrap_content” 
android:layout height=“wrap_content” 
android:id=“@+id/mybutton” 
android:src=“@android:drawable/stat_sys_phone call_on hold” 
>《!- 一 在 线性 布局 中 添加 一 个 ImageButton 控件 -一 > 
</ImageButton> 
< /LinearLayout> 


文件 test.js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get_ contents(”/sdcard/sl4a/scripts/mylayout. xml“) ; 
droid. fullShow (layout); 

droid. eventWait (10000) ; 


function file_get_contents (fileName) { 
var file=new java. io.File(fileName) ; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 


var fileString= 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close () ; 
return fileString; 


文件 mylayout. xml 通过 ImageButton 标签 添加 了 一 个 图 片 按钮 控件 ,通过 属性 
android: src 二 "@android:drawable/stat_sys_phone_call_on_hold" 为 图 片 按钮 定义 了 一 
张 系统 提供 的 标准 图 片 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目 录 . 然 后 再 运行 test. js, 屏 幕 会 出 现 一 个 图 片 按 钮 , 它 不 仅 可 以 像 
普通 按钮 一 样 被 单产 生 事 件 和 用 户 交 互 . 而 且 还 可 以 自 定 义 用 户 体 验 更 好 的 外 观 。 

例 5-8 说 明了 一 个 ImageButton 控件 .该 按钮 的 图 片 引用 了 已 上 传 到 移动 设备 中 的 
图 片 文件 资源 。 

【 例 5-8】 (代码 位 置 : \5\imagebutton2 目录 ) 

文件 mylayout. xml: 





< ?xml] version= “1.0” encoding= “utf— 8”?> 
<LinearLayout 


xmlns:android= “http://schemas. android. com/apk/res/android” 
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文件 test. js: 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 ,然后 在 该 布局 中 通过 
ImageButton 标签 添加 了 一 个 图 片 按钮 控件 .通过 属性 android: src 王 "file:///sdcard/ 
sl4a/scripts/earth. jpg" 引 用 了 图 片 文 件 资源 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js. 还 有 图 片 文 件 earth. jpg 都 复 
制 到 手机 或 模拟 器 中 的 /sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. js, 屏 幕 上 会 出 现 一 
个 图 片 按钮 , 它 的 外 观 是 图 片 文 件 earth. jpg, 可 以 像 普 通 按钮 一 样 被 单 击 。 
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5.5 RadibButon 和 CheckBox 


界面 上 经 常会 提供 一 组 选项 (含有 两 个 或 多 个 选项 ) 供 用 户 选择 ,这 一 组 中 的 选项 是 
互 斥 的 ,用 户 可 以 从 中 选择 一 项 并 且 只 能 选择 一 项 。 例 如 ,用 户 在 注册 时 , 有 时 会 出 现 一 
组 性 别 选 项 ,要 求 用 户 选 择 男 或 女 . 并 且 用 户 只 能 选择 其 中 一 项 ,如 图 5-1 所 示 。 这 个 功 
能 由 RadioButton 控件 和 RadioGroup 标签 共同 实现 。 

< 基 串 办 8:47 
请 选择 你 的 性 别 


(CES 一 RadioButton 控 件 


女 





图 5-1 RadioButton 控件 


RadioButton 也 称 单 选 按钮 控件 ,RadioGroup 是 单 选 组 合 框 ,用 于 将 RadioButton 框 
起 来 形成 一 组 单 选项 供用 户 选 择 。RadioButton 与 RadioGroup 的 关系 如 下 。 

(1) 每 个 RadioGroup 可 以 包含 两 个 或 两 个 以 上 的 RadioButton, 它 们 构成 一 组 单 选 
项 ,供用 户 选择 。 每 个 RadioGroup 中 的 RadioButton 控件 是 互 斥 的 ,只 能 有 一 个 被 选中 ; 

(2) 不 同 RadioGroup 中 的 RadioButton 控件 是 互 不 干涉 的 ; 

(3) 在 没有 RadioGroup 的 情况 下 .RadioButton 可 以 全 部 都 选中 

下 面 通过 实例 说 明 RadioButton 和 RadionGroup 。 例 5-9 描述 了 一 个 RadionGroup， 
在 这 个 RadionGroup 中 包含 两 个 RadioButton 控件 ,它们 是 互 斥 的 .用 户 只 能 选择 其 中 
一 个 

【 例 5-9】 〈 代 码 位 置 : \5\radioButton 目录 ) 

文件 mylayout. xml: 


《?xml version= "1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_height= “fill_ parent” 
android:background=“#ff000000” 
android:textSize=“25px” 
>《“!-- 描 述 一 个 线性 布局 -一 > 
《TextView 
android:text= 请 选择 你 的 性 别 :“ 
android:layout width=“wrap_content” 


android:layout_ height= “wrap_content” 
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文件 test.js: 
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在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 ,在 该 布局 中 通过 标签 
RadionGroup 添加 了 一 个 单 选 组 合 框 ,再 在 这 个 RadionGroup 中 通过 标签 RadioButton 
添加 了 两 个 单 选 按钮 控件 ,一 个 id 为 “boy”, 文 本 内 容 为 “ 男 ”, 另 一 个 id 为 “girl”, 文 本 内 
容 为 “ 女 ”, 通 过 id 区 分 单 选 按钮 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 

sdcard/sl4ayscripts/ 目录 ,然后 再 运行 test. js, 屏 幕 上 会 出 现 一 组 单 选 按钮 控件 ,一 个 是 
“ 男 ”, 另 一 个 是 “ 女 ”, 这 两 个 选项 用 户 只 能 选择 其 中 一 项 ,运行 结果 如 图 5-1 所 示 。 

界面 上 有 时 会 提供 一 些 选 项 供用 户 选 
择 , 这 些 选 项 是 不 互 斥 的 ,用户 可 以 从 中 选 
择 一 项 或 多 项 。 例 如 ,用 户 常会 遇 到 一 些 
调查 问卷 ,类 似 选 择 兴趣 爱好 , 用户 可 以 根 
据 自己 的 兴趣 ,选择 多 个 选项 。 如 图 5-2 
所 示 , 用 户 同 时 选择 了 “ 晶 歌 " 和 “游泳 ”等 
两 个 选项 ,说 明 该 用 户 的 兴趣 有 了 唱歌 和 游 
泳 。 这 个 功能 由 CheckBox 控件 实现 。 

CheckBox 控件 是 多 选 按 钮 控件 ,用 户 
可 以 同时 选中 多 个 CheckBox。CheckBox 控件 没有 分 组 概念 ,不 与 RadionGroup 结合 
使 用 。 

下 面 通过 实例 5-10 说 明 CheckBox 控件 ,该 例 在 一 个 垂直 线性 布局 中 ,添加 了 三 个 
CheckBox 控件 ,供用 户 多 选 。 

【 例 5-10】 〈 代 码 位 置 : \5\checkBox 目录 ) 

文件 mylayout. xml: 


-一 CheckBox 控 件 





图 5-2 多 选调 查 问 卷 


《?xml version=“1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_height= “fill parent” 
android:background= “#000000” 
><1 描述 二 个 线性 布局 > 
< TextView 
android:text= 请 选择 你 的 兴趣 :“ 
android:layout_width= “fill_parent” 
android:layout_height= “wrap_content” 
/2》《!- 一 在 线性 布局 中 添加 一 个 TextView 控件 -一 > 
《CheckBox 
android:id=“@+id/mycheckBox1” 
android:layout width= “wrap_content” 


android:layout_ height=“wrap_content” 


文件 test. js: 
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var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+tempString ; 
1 
reader. close () ; 
return fileString; 


} 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 ,然后 在 该 布局 中 从 上 到 下 
依次 添加 了 一 个 TextView ,三 个 CheckBox 控件 和 一 个 Button 控件 ,第 一 个 CheckBox 
控件 id 为 “mycheckBoxl”, 显示 内 容 为 “唱歌 ”, 第 二 个 CheckBox 控件 id 为 
“mycheckBox2”, 显 示 内 容 为 “ 打 篮 球 ”, 第 三 个 CheckBox 控件 id 为 “mycheckBox3”, 显 
示 内 容 为 “游泳 ", 用 户 可 以 进行 多 项 选择 。 

程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. js, 屏 幕 上 会 出 现 三 个 多 选 按钮 控件 ,用 户 可 
以 同时 选择 多 项 。 运 行 结果 如 图 5-2 所 示 。 


5.6 ToggEButon 


用 户 在 开启 WiFi 时 ,界面 上 会 出 现 一 个 按钮 控件 . 它 不 同 于 普通 按钮 控件 ,这 是 
ToggleButton 控件 。ToggleButton 控件 称 为 开关 按钮 控件 , 它 有 开 与 关 两 种 状态 。 
ToggleButton 控件 有 以 下 几 个 重要 的 属性 。 

属性 android:textOn 用 来 设置 控件 在 开 状态 下 要 显示 的 文字 ,如 android:textOn 一 
" 开 " 表 示 该 控件 在 开 状 态 下 要 显示 的 文字 为 “ 开 ”。 

属性 android:textOff 用 来 设置 控件 在 关 状 态 下 要 显示 的 文字 .如 android: textOff 
一 " 关 " 表 示 该 控件 在 关 状 态 下 要 显示 的 文字 为 “ 关 ”。 

属性 android:isChecked 用 来 判断 开关 按钮 的 状态 .属性 值 为 true 时 .说 明 开 关 按 钮 
为 开 状 态 ,属性 值 为 false 时 .说 明 开 关 按 钮 为 关 状态 。 

属性 android:checked 用 来 设置 开关 按钮 的 状态 ,属性 值 为 true 时 ,说 明 设 置 开关 按 
钮 为 开 状 态 .属性 值 为 false 时 ,说明 设置 开关 按钮 为 关 状 态 。 

下 面 通过 实例 5-11 说 明 ToggleButton 控件 .该 例 描述 了 一 个 开关 按钮 .用 户 可 以 通 
过 该 按钮 控制 程序 的 状态 : 开 状 态 或 关 状 态 。 

【 例 5-11】 (代码 位 置 : \5\togglebutton 目录 ) 

文件 mylayout. xml: 


< ?xml] version= ”1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 


android:orientation= “vertical” 


文件 test. js: 
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} 
reader. close (); 
return fileString; 


} 


在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 ,然后 在 该 线性 布局 中 添加 
了 一 个 ToggleButton 控件 ,通过 属性 android: checked 二 "true" 设 置 开关 按钮 为 打开 状 
态 , 再 在 该 线性 布局 中 添加 了 一 个 Button 控件 用 来 退出 这 个 程序 。 

程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. js, 屏 幕 上 会 显示 两 个 按钮 ,一 个 是 开关 按 
钮 ,状态 为 打开 状态 , 另 一 个 是 普通 按钮 ,如 图 5-3 所 示 。 当 单 击 开 关 按 钮 时 ,开关 按钮 上 
的 文字 会 发 生变 化 ,开关 按钮 状态 变 为 关闭 状态 。 当 单 击 普 通 按钮 时 ,程序 会 结束 。 





(a) 开 状态 (b) 关 状 态 


5-3 ”开关 按钮 


5.7 DataPicker 和 TinePicker 


用 户 在 进行 网 络 订 票 时 .需要 选择 出 行 的 日 期 和 时 间 , 用 户 在 进行 网 络 订 房 时 ,需要 
选择 入 住 和 退 房 的 日 期 和 时 间 。Android 提供 了 DataPicker 和 TimePicer 控件 实现 这 些 
功能 ,用 户 可 以 通过 系统 提供 的 万 年 历 选择 时 间 和 日 期 ,而 不 需要 进行 手工 输入 

DataPicker 控件 是 日 期 选择 控件 ,主要 功能 是 向 用 户 提供 包含 年 .月 .日 的 日 期 数据 
并 允许 用 户 对 其 进行 选择 。TimePicer 控件 是 时 间 选 择 控件 .时 间 选 择 控件 向 用 户 显 示 
一 天 中 的 时 间 ( 可 以 为 24 小 时 ,也 可 以 为 AM/PM 制 ) ,并 允许 用 户 进行 选择 

下 面 通 过 实例 5-12 说 明 DataPicker 控件 和 TimePicer 控件 , 用户 可 以 通过 
DataPicker 控件 选择 日 期 .通过 TimePicer 控件 选择 时 间 。 

【 例 5-12】 (代码 位 置 : \5\dtpicker 目录 ) 

文件 mylayout. xml: 


《9?xml version=“1.0” encoding= “utf- 8”?> 

<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 


android:layout width= “fill parent” 
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文件 test.js: 
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var file=new java. io.File (fileName):; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)):; 
var tempString=null; 


var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close () ; 
return fileString; 


} 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 ,在 该 布局 中 添加 了 一 个 
DataPicker 控件 和 一 个 TimePicer 控件 ,用 来 选择 日 期 和 时 


间 , 最 后 在 该 线性 布局 中 添加 了 一 个 Button 控件 ,文本 内 容 为 一 一 
“提交 设置 ”, 用 来 提交 日 期 和 时 间 的 设置 。 
程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复 一 一 
制 到 手机 或 模拟 器 中 的 /sdcard/sl4a/scripts/ 目 录 , 然 后 再 运 

行 test js, 屏幕 上 会 显示 日 期 和 时 间 选 择 视图 ,用 户 可 以 单 击 站 
“十 ?或 “一 ”符号 修改 日 期 和 时 间 , 但 此 时 并 没有 发 生变 化 , 因 
为 其 并 没有 响应 事件 .关于 事件 在 后 面 章 节 介 绍 。 单 击 * 提 交 
设置 "按钮 可 以 退出 该 程序 。 运 行 结 果 如 图 5-4 所 示 5-4 日 期 和 时 间 





5.8 IhageView 


Android 提供 了 ImageView 控件 用 来 显示 图 像 . 它 可 以 加 载 系统 标准 资源 和 图 片 文 
件 资源 ,引用 的 格式 与 前 面 介绍 ImageButton 控件 时 引用 图 片 资源 的 格式 是 相同 的 。 
ImageView 可 以 指定 修改 原 图 的 尺寸 大 小 。 

下 面 通过 实例 5-13 说 明 ImageView 控件 .该 例 中 显示 了 两 个 图 像 .其 中 第 一 个 引用 
了 系统 提供 的 标准 图 像 资源 ,第 二 个 引用 图 像 文 件 资源 。 

【 例 5-13】 (代码 位 置 : \5\imageview 目录 ) 

文件 mylayout. xml: 


《2?xml version=”1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout _ height= “fill parent” 
android:background= “#ff000000” 
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>< !-- 描 述 一 个 垂直 线性 布局 -一 > 

< ImageView 
android:src=“@android:drawable/stat_sys_phone call_on hold” 
android:layout_width= “100px” 
android:layout_height=“100px” 

>《“!-- 在 垂直 线性 布局 中 添加 第 一 个 InageView 控件 --> 
</ImageView> 

< ImageView 

android:src= “file:///sdcard/sl4a/scripts/earth. jpg” 
android:layout width=“150px” 
android:layout_height=“150px” 

>《!-- 在 垂直 线性 布局 中 添加 第 二 个 ImageView 控件 -一 > 
< /ImageView> 

< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xml1”); 
droid. fullShow (layout) ; 

var retl= droid. eventWait (10000) ; 


function file_get_contents (fileName) { 
var file=new java. io. File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 





var fileString=““; 
// 一 次 读 入 一 行 ,直到 读 入 null 时 文件 结束 
while ((tempString= reader. readLine()) !=null) { 


fileString=fileString+ tempString ; 
} 
reader. close (); 


return fileString; 


在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 .添加 了 
两 个 ImageView 控件 。 第 一 个 ImageView 控件 通过 属性 android: src 一 "@ android: 
drawable/stat_sys_phone_call_on_ hold" 说 明显 示 的 图 片 来 源 于 系统 提供 的 标准 图 片 资 
源 . 第 二 个 控件 通过 属性 android: src 一 "file:///sdcard/sl4a/scripts/moon. png" 说 明显 
示 的 图 片 来 源 于 文件 图 像 。 两 个 控件 通过 属性 android:layout_height 和 android:layonut 
_ width 分 别 指定 了 图 像 的 高 度 和 宽度 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js. 还 有 图 片 文 件 earth. jpg 都 复 
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制 到 手机 或 模拟 器 中 的 /sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. php, 屏 幕 上 会 显示 
两 张 图 片 , 其 中 ,电话 图 像 来 源 于 系统 标准 图 像 资源 .地 球 图 像 来 源 于 文件 图 像 资源 。 


59 PioglessBarSeekBar 和 RatngBar 


用 户 进 行文 件 下 载 时 , 常 需 要 一 些 时 间 ,界面 上 会 出 现 一 个 控件 ,显示 文件 下 载 的 进 
度 ,SL4A 提供 了 ProgressBar 控件 实现 该 功能 。ProgressBar 控件 也 就 是 进度 条 控件 . 它 
有 两 个 进度 条 .分 别称 为 第 一 层 进度 条 和 第 二 层 进度 条 .第 一 层 进度 条 为 用 户 呈 现 操 作 的 
进度 ,第 二 层 用 来 显示 中 间 进 度 。 例 如 .在 文件 下 载 进度 条 中 ,第 一 层 进度 条 ,颜色 较 深 ， 
用 来 显示 文件 下 载 进度 .第 二 层 进 度 条 .颜色 较 浅 .用 来 显示 缓冲 区 进度 。 进度 条 也 可 以 
应 用 于 程序 任务 完成 时 间 不 确定 的 情景 。PFA 对 使 用 XML 描述 ProgressBar 进度 条 的 
支持 不 够 ,ProgressBar 控件 的 使 用 可 参看 前 面 章节 的 介绍 。 

Andrroid 还 提供 了 SeekBar 控件 . 它 是 可 拖 动 进度 条 ,与 ProgressBar 控件 不 同 的 是 
在 SeekBar 控件 上 有 一 个 滑 块 .用 户 不 仅 可 以 通过 滑 块 的 位 置 来 显示 进度 .而 且 可 以 拖 动 
滑 块 来 改变 进度 值 , 因 此 拖 动 进度 条 通常 用 于 对 系统 的 某 种 数值 进行 调节 ,比如 调节 音 
量 .调节 手机 屏幕 亮度 等 。 

SeekBar 控件 常用 的 属性 如 下 。 

android:max: 该 属性 表示 进度 条 最 大 值 . 例 如 ,android:max 一 "100" 表 示 进 度 条 最 
大 值 为 100。 

android:progress: 该 属性 表示 进度 条 当前 值 .例如 .android:progress 一 "50" 表 示 进 
度 条 当前 大 为 50。 

android:secondaryProgress: 该 属性 表示 第 二 层 进 度 条 的 进度 值 .例如 ,android: 
secondaryProgress 一 "80" 表 示 第 二 层 进度 条 的 进度 值 为 80。 

下 面 通过 实例 5-14 说 明 SeekBar 控件 。 该 例 描述 了 两 个 SeekBar 控件 ,并 且 分 别 给 
出 了 两 个 进度 条 的 最 大 值 .当前 值 和 第 二 层 进度 条 的 进度 值 。 

【 例 5-14】 (代码 位 置 ; \5\seekbar 目录 ) 

文件 mylayout. xml: 





< ?xml version=“1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:layout width= “fill parent” 
android:layout height= “fill parent” 
android:orientation= “vertical” 
android:background=“#ff000000” 
>《!-- 描 述 一 个 垂直 线性 布局 --> 
< SeekBar 
android:layout width= “fill parent” 
android:layout _ height=“wrap_content” 


android:layout_alignParentBottom= “true” 
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android:layout marginBottom=“10dp” 
android:secondaryProgress=“50” 
android:max=“100” 
android:progress= “30” 
/>《!-- 在 垂直 线性 布局 中 添加 第 一 个 SeekBar 控件 -一 > 

< SeekBar 
android:layout width= “fill parent” 
android:layout_height=“wrap_content” 
android:layout alignParentBottom= “true” 
android:secondaryProgress= “90” 
android:max= “100” 
android:progress= “60” 

/2》《 !-- 在 垂直 线性 布局 中 添加 第 二 个 SeekBar 控件 -一 > 


< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get_contents(”/sdcard/sl4a/scripts/mylayout. xml”); 
droid. fullShow (layout); 

var retl= droid. eventWait (12000) ; 


function file get_contents (fileName) { 
var file=new java. io. File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 时 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 


return fileString; 


在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 .通过 标 
签 SeekBar 依次 添加 两 个 SeekBar 控件 .在 第 一 个 SeekBar 控件 中 ,通过 属性 android: 
max 设置 了 进度 条 最 大 值 为 100 ,通过 属性 android:progress 设置 了 进度 条 当前 值 为 30. 
通过 属性 android: secondaryProgress 设置 了 第 二 层 进度 条 的 进度 值 为 50。 在 第 二 个 
SeekBar 控件 中 .通过 属性 android:max 设置 了 进度 条 最 大 值 为 100. 通 过 属性 android : 
progress 设置 了 进度 条 当前 值 为 60 .通过 属性 android:secondaryProgress 设置 了 第 二 层 
进度 条 的 进度 值 为 90。 
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程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 

sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. js， 
屏幕 上 从 上 到 下 依次 出 现 两 个 拖 动 进度 条 ,运行 
结果 如 图 5-5 所 示 。 

RatingBar 是 评分 控件 . 也 则 评分 条 .是 
SeekBar 和 ProgressBar 的 扩展 。 通 过 评分 条 ,用 
户 可 以 评分 和 进行 等 级 划分 。 这 种 评分 条 默认 有 
SeekBar 控件 5 个 星 图 案 , 用 户 可 以 通过 单 击 \ 触 摸 、 拖 动 或 使 

用 键 来 改变 星星 的 数量 进行 评分 ,选中 星星 数量 
越 多 评分 也 越 高 。 例 如 ,用户 通过 网 络 购买 商品 后 ,可 通过 评分 条 对 该 商品 进行 评价 。 
通过 设置 属性 可 以 改变 星星 的 数量 和 水 平抑 动 步伐 等 方面 的 内 容 , RatingBar 控件 
常用 的 属性 如 下 。 

android:isIndicator: 该 属性 表示 评分 条 是 否 是 一 个 指示 器 ,true 表示 评分 条 是 一 个 
指示 器 (用 户 无 法 进行 拖 动 星星 图 案 的 操作 ) 。 

android:numStars: 该 属性 用 来 设置 要 显示 星星 的 数量 ,必须 是 一 个 整形 值 ,例如 ， 
android:numStars 一 "6"。 

android:rating: 该 属性 表示 默认 的 评分 ,是 浮 点 类 型 ,例如 ,android:rating 一 "1.5"。 

属性 android:stepSize: 该 属性 用 来 设置 评分 的 步 长 ,也 就 是 评分 条 每 次 前 进 多 少 ， 
是 浮 点 类 型 .例如 ,android:stepSize 一 "1.0"。 

下 面 通过 实例 5-15 说 明 RatingBar 控件 ,该 例 描 述 了 三 个 评分 条 ,第 一 个 评分 条 有 
三 个 星星 图 案 .初始 有 一 个 半 星 星 图 案 被 选中 .水平 拖 动 步伐 是 0. 5, 第 二 个 评分 条 是 使 
用 默认 属性 值 的 评分 条 ,默认 的 评分 条 有 5 个 星星 图 案 和 使 用 默认 的 拖 动 步伐 .第 三 个 评 
分 条 有 4 个 星星 图 案 , 一 个 是 指示 器 , 它 只 能 显示 星星 图 案 而 不 能 拖 动 星星 图 案 。 

【 例 5-15】 (代码 位 置 : \5\ratingbar 目录 ) 

文件 mylayout. xml: 








《<?xml version= ”1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:layout width= “fill_parent” 
android:layout_height= “fill parent” 
android:orientation= “vertical” 
>《“!-- 描 述 一 个 垂直 线性 布局 --> 
《RatingBar 
android:layout_width= “wrap_content” 
android:layout_height= “wrap_content” 
style= ?android:attr/ratingBarStyleIndicator” 
android:numStars= 3”“!-- 设 置 要 显示 的 星星 数量 --> 
android:rating=“1.5”《 !-- 设 置 默认 的 评分 --> 
android:stepSize= “0.5“!-- 设 置 评 分 的 步 长 --> 
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/>《!-- 在 垂直 线性 布局 中 添加 第 一 个 RatingBar 控件 -一 > 
< RatingBar 
android:layout width=“wrap_content” 
android:layout height=“wrap_content” 
style=”?android:attr/ratingBarStyleIndicator” 
/>《!-- 在 垂直 线性 布局 中 添加 第 二 个 RatingBar 控件 -一 > 
<RatingBar 
android:layout width=“wrap_content” 
android:layout height=“wrap_content” 
style=“?android:attr/ratingBarStyleIndicator” 
android:numStars= “4” 
android:isIndicator= “true” 
/>《 1!-- 在 垂直 线性 布局 中 添加 第 三 个 RatingBar 控件 -一 > 


< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file_ get_contents(”/sdcard/sl4a/scripts/mylayout. xml”); 
droid. fullShow (layout); 

var retl= droid. eventWait (12000) ; 


function file_get_contents (fileName) { 
var file=new java. io. File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 








var fileString= 一 ; 
// 一 次 读 入 一 行 ,直到 读 入 null 时 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 


return fileString; 


Widget 


在 文件 mylayout. xml 中 ,首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 .通过 标 
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签 RatingBar 依次 添加 三 个 评分 条 .第 一 个 评分 条 通过 属性 android: numStars 设置 星星 
数量 为 3. 通过 属性 android: rating 设置 初始 有 一 个 半 星 星 图 案 被 选中 ,通过 属性 
android: stepSize 设置 水 平抑 动 步伐 是 0. 5. 第 二 个 评分 条 是 使 默认 属性 值 的 评分 条 .使 
用 默认 的 步 长 .默认 有 5 个 星星 图 案 : 第 三 个 评分 条 有 4 个 星星 图 案 . 通 过 属性 
android :isIndicator 一 "true" 设 置 该 评分 条 是 指示 器 . 它 只 能 显示 星星 图 案 而 不 能 拖 动 星 
星 图 案 。 


Andioid 脚本 必用 开发 技术 


程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 

sdcard/sl4a/scripts/ 目 录 . 然 后 再 运行 test. php, 屏 幕 
从 上 到 下 依次 出 现 三 个 评分 条 ,第 一 个 评分 条 有 三 个 星 
星 .起 初 有 一 个 半 星 星 被 选中 ,用 户 可 以 拖 动 继续 选中 
未 选中 的 星星 .第 二 个 评分 条 有 5 个 星星 ,起 初 都 没有 
选中 ,用 户 可 以 拖 动 继续 选中 未 选中 的 星星 ,第 三 个 评 
分 条 有 4 个 星星 ,起 初 都 没有 选中 ,因为 属性 android 
isIndicator 值 为 真 ,所 以 它 是 指示 器 ,用 户 不 能 拖 动 星 
星 图 案 。 运 行 结果 如 图 5-6 所 示 。 





5.10 Spiner 和 List jew 


Spinner 控件 是 下 拉 列 表 控件 . 单 击 后 弹出 一 个 对 话 框 ,显示 几 个 供 选 择 的 选项 , 例 
如 ,用 户 在 登录 电子 邮箱 时 .会 遇 到 一 个 下 拉 列 表 , 单 击 后 弹出 一 个 对 话 框 ,显示 一 些 可 供 
选择 的 邮箱 服务 器 域名 ,用 户 可 以 单 击 进行 选择 。 下 拉 列 表 与 单 选 按钮 都 是 单 选 ,但 是 当 
选项 太 多 时 ,如 果 使 用 单 选 按钮 ,会 占用 屏幕 很 大 空间 ,而 手机 屏幕 大 小 有 限 ,使 用 
Spinner 控件 是 一 种 很 好 的 解决 这 个 问题 的 方法 。 

下 拉 列 表 控 件 需 要 绑 定 选 项 数据 集合 才能 显示 出 选项 的 文本 内 容 , 系 统 提供 了 函数 
fullSetList 用 来 绑 定 数据 。 


fullSetList (String id，JSONArray list) 


该 函数 用 于 将 列表 数据 选项 绑 定 到 下 拉 列 表 控件 .参数 id 表示 下 拉 列 表 控 件 的 id， 
参数 list 是 列表 选项 数据 集合 .可 用 数组 表示 。 

下 面 通 过 实例 5-16 说 明 Spinner 控件 。 该 例 描述 了 一 个 下 拉 列 表 控件 .下 拉 列 表 中 显 
示 的 选项 来 源 于 文件 test.js 中 定义 的 数组 mylist. 用 户 可 以 选择 下 拉 列 表 中 显示 的 选项 。 

【 例 5-16】 “代码 位 置 : \5\list 目录 ) 

文件 mylayout. xml: 


< ?xml version=“1.0” encoding= “utf— 8”?> 

<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:layout width= “fill parent” 
android:layout height= “fill parent” 
android:orientation= “vertical” 
android:background=“#ff000000” 

><!-- 描 述 一 个 垂直 线性 布局 -一 > 

< TextView 

android:text=“ 请 选择 你 所 在 的 城市 :” 
android:textSize= “15dp” 


android:layout width=“wrap_content” 
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android:layout_height= “wrap_content” 
/>《!-- 在 垂直 线性 布局 中 添加 一 个 TextView 控件 -一 > 
“Spinner 


android:id=“@+id/spinner” 





android:layout_height= “wrap_content” 
android:layout width= “fill parent” 


/>《“!-- 在 垂直 线性 布局 中 添加 一 个 Spinner 控件 --> 
< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get_contents(”/sdcard/sl4a/scripts/mylayout. xml”); 
droid. fullShow (layout); 

var mylist=new Array(); 

mylist[0]=“ 广 州 ; 

mylist[1]=“ 深 圳 “; 

mylist[2]= “海口 ”; 

droid. fullSetList (“spinner”, mylist); 

var retl= droid. eventWait (10000) ; 


function file_ get_contents (fileName) { 
var file=new java. io. File (fileName); 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString= 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
9 
reader. close (); 


return fileString; 


在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 通过 标签 
Spinner 添加 一 个 下 拉 列 表 控 件 .通过 属性 android:id 设置 ID 号 为 "spinner”。 

在 文件 test.js 中 定义 了 数组 mylist. 通 过 函数 fullSetList("spinner", $mylist) 将 数 
组 mylist 绑 定 到 ID 号 为 “spinner” 的 下 拉 列 表 . 下 拉 列 表 中 显示 的 选项 是 数组 mylist 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目 录 . 然 后 再 运行 test. js, 屏 幕 上 会 出 现 一 个 文本 框 .显示 “请 选择 
你 所 在 的 城市 ”. 一 个 下 拉 列 表 . 用 户 可 以 单 击 列 表 . 列 表 会 弹出 对 话 框 显示 “广州 “深圳 ” 
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和 “海口 "三 个 选项 ,用 户 可 以 单 击 选项 或 拉动 列表 进行 选择 ,运行 结果 如 图 5-7 所 示 。 

Android 中 还 提供 3 另 一 种 列表 控件 ListView 控 
件 . 它 经 常会 使 用 列表 的 形式 来 显示 一 些 内 容 选项 供用 户 单 
击 选择 。 与 下 拉 列 表 (Spinner 控件 ) 不 同 的 是 .ListView 控 
件 直 接 以 列表 的 形式 向 用 户 显示 数据 选项 .而 下 拉 列 表 需 要 
用 户 单 击 下 拉 列 表 后 才 以 列表 的 形式 向 用 户 显示 数据 选项 。 

ListView 控件 同样 需要 函数 fullSetList() 将 列表 数据 选 
项 绑 定 到 控件 , ListView 控件 还 可 以 通过 属性 android: 
drawSelectorOnTop 设置 选中 条 样式 .其 值 可 取 true 和 
false。 例 如 .android:drawSelectorOnTop 二 "true" 表 示 单 击 
某 一 条 记录 ,选中 条 颜色 会 显示 在 最 上 面 ,记录 上 的 文字 被 
庶 住 ,android:drawSelectorOnTop 二 "false” 表 示 选 中 某 条 记录 ,颜色 会 在 记录 的 后 面 ， 
成 为 背景 色 , 而 记录 上 文字 是 可 见 的 。 

下 面 通过 实例 5-17 说 明 ListView 控件 。 该 例 描述 了 一 个 ListView 列表 控件 ,用 户 
可 以 选择 列表 中 显示 的 选项 .列表 控件 中 用 图 像 作为 列表 的 背景 ,列表 中 显示 的 选项 来 源 
于 文件 test. js 中 定义 的 数组 mylist。 

【 例 5-17】 (代码 位 置 : \5\listview 目录 ) 

文件 mylayout. xml: 








《?xml version= "1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:layout width= “fill parent” 
android:layout_height= “fill parent” 
android:orientation= “vertical” 
android:id=“@+id/LinearLayout01” 
android:background=“#ff000000” 
>《 !-- 描 述 一 个 垂直 线性 布局 -一 > 
< TextView 
android:text= 请 选择 你 所 在 的 城市 :“ 
android:textSize=“15dp” 
android:layout width= “wrap_content” 
android:layout_height= “wrap_content” 
/>《!-- 在 垂直 线性 布局 中 添加 一 个 TextView 控件 -一 > 
<ListView 
android:layout width=“wrap_content” 
android:layout _ height=“wrap_content” 
android:id=“@+id/ListView01” 
android:drawSelectorOnTop= “false” 
android:background= “file:///sdcard/sl4a/scripts/esrth. jpg” 
/2《 !-- 在 垂直 线性 布局 中 添加 一 个 ListView 控件 -一 > 
</LinearLayout> 


108 


第 5 这 Andreid Widget 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var layout=file get contents(”/sdcard/sl4a/scripts/mylayout. xml“) ; 
droid. fullShow (layout); 

var mylist=new Array(); 

mylist[0]=“ 广 州 ; 

mylist[1]=“ 深 圳 “; 

mylist[2]= “海口 ; 

droid. fullSetList (ListView01”, mylist); 

var ret= droid. eventWait (10000) ; 


function file_get_contents(fileName) { 
var file=new java. io.File(fileName) ; 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 


var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close(); 
return fileString; 


} 


在 文件 mylayout. xml 中 .首先 定义 了 一 个 垂直 线性 布局 .然后 在 该 布局 中 通过 标签 
ListView 添加 一 个 列表 控件 ,通过 属性 android:id 设置 控件 的 ID 号 为 “istView01” ,通过 
属性 android:drawSelectorOnTop 二 "false" 设 置 被 选中 记录 上 的 文字 可 见 , 背 景色 在 文字 
后 面 .通过 属性 android:background 设置 背景 来 源 于 文件 图 像 。 

在 文件 test php 中 定义 了 数组 mylist, 通过 函数 fullSetList ("ListView01"， 
$ mylist) 将 数组 mylist 绑 定 到 ID 号 为 ListView01 的 沪 pr 
列表 ,列表 中 显示 的 选项 是 数组 mylist 元 素 内 容 。 请 选择 你 所 在 的 城市 : 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 
test. php, 还 有 图 片 文 件 earth. jpg 都 复制 到 手机 或 模 
拟 器 中 的 /sdcard/sl4a/scripts/ 目 录 . 然 后 再 运行 test. 
php, 屏 幕 上 会 出 现 一 个 文本 框 .显示 “请 选择 你 所 在 的 
城市 ”, 还 有 一 个 列表 ,包含 “广州 “深圳 "和 “海口 "三 
个 选项 ,用 户 可 以 单 击 列表 选项 进行 选择 .该 列表 用 
像 作为 背景 .运行 结果 如 图 5-8 所 示 。 





图 5-8 列表 
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5.11 Menu 


菜单 (Menu) 是 用 户 界 面 中 最 常见 的 元 素 之 一 ,使 用 非常 频繁 ,系统 提供 了 选项 菜单 
(OptionsMenu) 和 上 下 文 菜单 (ContextMenu) ,下 面 将 进行 介绍 。 

用 户 按 下 手机 或 模拟 器 上 的 菜单 按钮 (Menu 键 ) 时 ,在 屏幕 底 端 弹出 6 个 相应 选项 
的 菜单 ,用 户 可 单 击 选 项 进行 相应 的 操作 ,该 菜单 是 选项 菜单 (OptionsMenu) 。 

选项 菜单 (OptionsMenu) 功 能 需要 开发 人 员 编 程 实现 ,如 果 在 开发 应 用 程序 时 没有 
实现 该 功能 ,那么 程序 运行 时 按 下 手机 或 模拟 器 上 的 菜单 按钮 (Menu 键 ) 是 不 会 起 作用 
的 。 选 项 菜单 最 多 显示 6 个 菜单 项 .这些 菜单 项 可 包含 文字 和 图 标 , 当 菜单 选项 多 于 6 个 
选项 时 ,将 只 显示 前 5 个 选项 和 一 个 扩展 菜单 选项 ,扩展 菜单 选项 包含 第 6 个 选项 以 及 以 
后 的 菜单 选项 ,用户 单 击 扩 展 菜单 选项 将 会 弹出 其 余 的 菜单 选项 。 

开发 人 员 需 要 往 选 项 菜单 中 添加 和 删除 菜单 项 ,Android 提供 了 相关 的 函数 完成 这 
些 操作 , 下 面 介 绍 相关 函数 。 


add0ptionsMenuItem(String label, String event, Object eventData, String iconName) 


该 函数 用 于 为 选项 菜单 添加 菜单 项 ,其 中 ,参数 label 表示 菜单 项 的 标签 ;参数 event 
表示 该 菜单 项 被 单 击 时 产生 事件 的 名 称 ; 参 数 eventData 表示 事件 附带 的 数据 ,该 参数 是 
可 选 的 ;参数 iconName 表示 图 标 名 称 , 图 标 由 系统 提供 ,该 参数 是 可 选 的 ,有 关 图 标 资源 


可 参看 http://developer. android. com/reference/android/R. drawable. html。 


clear0ptionsMenu () 


该 函数 用 于 删除 选项 菜单 中 的 所 有 菜单 项 。 

下 面 通过 实例 5-18 说 明 选 项 菜单 ,在 该 选项 菜单 中 添加 了 三 个 菜单 项 ,用 户 可 以 选 
择 莱 单项 进行 相应 的 操作 

【 例 5-18】 〈 代 码 位 置 : \5\optionsmenu 目录 ) 

文件 mylayout. xml: 


《9?xml version=“1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” 
android:layout_ height= “fill parent” 
android:background=“# 000000” 
>《!-- 描 述 一 个 垂直 线性 布局 -> 
< TextView 
android:text= 提示: 按 MENU 按键 弹出 菜单 .” 


android:layout width=“wrap_content” 
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在 文件 test. js 中 通过 函数 addOptionsMenultem 添加 了 三 个 菜单 项 .每 个 菜单 项 都 
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带 有 图 标 , 第 一 个 菜单 项 的 标签 为 “选项 1" .被 单 击 时 产生 的 事件 为 iteml, 事 件 没 有 附带 
的 数据 ,图 标的 名 称 为 star_ on。 第 二 个 菜单 项 的 标签 为 “选项 2” ,被单 击 时 产生 的 事件 
为 item2 ,事件 没有 附带 的 数据 ,图 标的 名 称 为 star_off。 第 三 个 菜单 项 的 标签 为 “选项 
3”, 被 点 击 时 产生 的 事件 为 item3 ,事件 没有 附带 的 数据 .图 标的 名 称 为 ic_menu_revert。 
程序 运行 之 前 , 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
/sdcard/sl4a/scripts/ 目录 .然后 再 运行 test. js, 屏 幕 上 会 出 现 一 个 文本 框 , 显 示 内 容 为 
“提示 : 按 MENU 按键 弹出 菜单 . "还 有 一 个 “退出 ”按钮 。 
当 用 户 单 击 模拟 器 中 的 MENU 按键 时 .屏幕 底部 会 弹出 
菜单 ,菜单 有 三 个 菜单 项 ,每 个 菜单 项 都 带 有 图 标 , 第 一 个 
图 标 是 一 个 亮 的 星星 ,第 二 个 图 标 是 一 个 暗 的 星星 ,第 三 
个 图 标 是 一 个 返回 图 标 ,用 户 可 以 单 击 菜单 项 进行 相关 操 
作 , 要 想 结束 程序 ,用 户 可 单 击 “ 退 出 ”按钮 ,其 运行 结果 如 
图 5-9 所 示 。 
用 户 长 按 手机 或 模拟 器 桌面 空白 处 时 ,桌面 会 弹出 一 
> 个 菜单 ,菜单 里 包含 多 个 选项 ,用 户 可 以 单 击 选项 进行 相 
加 关 的 操作 .该 菜单 是 上 下 文 菜单 (ContextMenu) 。 
Android 系统 中 的 上 下 文 菜单 (ContextMenu) 类 似 
于 PC 中 的 右键 弹出 菜单 , 当 用 户 进 行 长 按 动作 时 ,将 出 
现 一 个 提供 相关 功能 的 浮动 菜单 .上 下 文 菜单 不 支持 图 标 和 快捷 键 。SL4A 提供 的 
上 下 文 菜单 主要 用 于 WebView。SL4A 内 建 有 HTML 解释 器 和 API 用 于 控制 
WebView, 从 而 能 利用 HTML5 制作 程序 界面 :这样 能 让 Web 开发 人 员 快 速 地 开发 
Android 程序 。 
下 面 介绍 控制 WebView 和 上 下 文 菜单 相关 的 函数 





图 5-9 选项 菜单 


webViewShow (String url, Boolean wait) 


该 函数 用 于 显示 一 个 指定 URL 的 WebView ,参数 url 表示 HTML 文件 ,参数 wait 
是 布尔 类 型 变量 ,默认 值 是 false, 该 参数 用 来 表示 是 否 以 堵塞 方式 运行 WebView,true 
表示 以 堵塞 方式 运行 WebView.false 表示 以 非 堵塞 方式 运行 .该 参数 是 可 选 的 。 

addContextMenuItem(String label, String event, Object eventData) 

该 函数 用 于 添加 上 下 文 菜单 项 .其 中 .参数 label 表示 菜单 项 的 标签 ;参数 event 表示 
该 菜单 项 被 单 击 时 产生 事件 的 名 称 ; 参数 eventData 表示 事件 附带 的 数据 .该 参数 是 可 
选 的 。 

clearContextMenu () 

该 函数 用 于 删除 上 下 文 菜单 所 有 菜单 项 。 

下 面 通过 实例 5-19 说 明 上 下 文 菜单 .在 该 上 下 文 菜单 中 添加 了 三 个 菜单 项 .用 户 可 
以 对 这 三 个 菜单 项 进行 选择 。 本 例 包 含 两 个 文件 .一 个 是 HTM 文件 test. htm; 另 一 个 是 
PHP 文件 test. js。 
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【 例 5-19】 (代码 位 置 : \5\contextmenu 目录 ) 
文件 test. htm : 


<html xmlns=“http://www. w3. org/1999/xhtml” xml:lang= “en” lang= “en”> 

<head> 
《meta http- equiv= “content- type” content= “text/html; charset=utf8” /> 
《meta name= “author” content= “WWW. DOWNG. COM” /> 

< /head> 

<body> 

提示 : 长 按 2 秒 弹 出 菜单 。 

< /body> 

</html> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

droid. webViewShow (“file:///sdcard/sl4a/scripts/test. htm”); 

droid. addContextMenuItem(“ 选 项 1”, “item1”, nul1); 

droid. addContextMenuItem(“ 选 项 2”, “item2”, nul1); 

droid. addContextMenuItem(“ 选 项 3”, “item3”, nul1); 

droid. eventWait (30000) ; 


在 文件 test. htm 中 通过 HTML 描述 了 一 个 Web 页 面 .其 显示 内 容 为 “提示 : 长 按 
2 秒 弹 出 菜单 。” 

在 文件 test. js 中 通过 函数 webViewShow 显示 一 个 Web 页 面 ,该 Web 页 面 所 对 应 
的 文件 是 test. htm ,通过 函数 addContextMenultem 添加 了 三 个 菜单 项 .第 一 个 菜单 项 显 
示 的 标签 分 别 为 “选项 1”. 被 单 击 时 产生 的 事件 为 iteml ,第 
二 个 菜单 项 显示 的 标签 分 别 为 “选项 2”. 被 单 击 时 产生 的 事 
件 为 item2 ,第 三 个 菜单 项 显示 的 标签 分 别 为 “选项 3”, 被 单 
击 时 产生 的 事件 为 item3 。 

程序 运行 之 前 . 先 把 文件 test. htm 和 文件 test. js 复制 
到 手机 或 模拟 器 中 的 /sdcard/sl4a/scripts/ 目录. 然后 再 运行 
test. php, 屏 幕 上 会 显示 test. htm 界面 .界面 中 显示 文本 “ 提 
示 : 长 按 2 秒 弹 出 菜单 .”", 当 用 户 在 界面 中 长 按 2s, 这 时 会 弹 
出 一 个 上 下 文 菜单 .该 菜单 包含 三 个 选项 .分 别 为 “选项 1”、 
“选项 2”、“ 选 项 3”. 用 户 可 以 单 击 进行 选择 。 运 行 结果 如 
5-10 所 示 。 





5-10 上 下 文 菜单 
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6.1 事件 处 理 模型 


事件 在 现实 生活 中 是 普遍 存在 的 .从 人 类 对 世界 的 认 知 角度 看 .凡是 产生 了 影响 、 意 
义 的 变更 就 是 事件 ,自然 界 无 时 无 刻 不 在 发 生 着 某 种 变化 ,只 有 产生 了 影响 ,引起 了 重视 
才 是 事件 ,如 某 地 发 生地 震 .对 该 地 人 们 产生 了 重大 影响 .这 是 事件 ,又 如 某 人 考 上 了 大 
学 ,对 他 的 人 生来 说 会 产生 有 影响 有 意义 的 变化 .这 也 是 事件 。 

从 计算 机 角度 看 ,所 有 的 0、1 序列 的 位 变化 都 可 定义 为 事件 ,如 操作 键盘 .鼠标 等 引 
起 的 变更 ,这 个 变更 就 是 事件 .这 些 变更 可 以 实现 人 机 互动 .包括 单 击 事件 .按键 事件 、 鼠 
标 拖 动 事件 等 。 

事件 驱动 在 应 用 中 非常 普遍 ,现代 的 用 户 界面 .都 是 以 事件 驱动 的 方式 来 实现 人 机 交 
互 的 .比如 用 户 单 击 了 某 个 按钮 ,应 用 程序 就 会 对 用 户 的 动作 做 出 相应 的 响应 。 事件 驱动 
在 计算 机 系统 中 也 是 非常 重要 的 ,可 以 想象 ,如 果 设 计 出 一 台 没有 键盘 、 鼠 标 等 事件 驱动 
的 计算 机 ,那么 这 台 计 算 机 也 就 是 一 台 看 着 复杂 的 电视 机 或 DVD 而 已 。 

对 于 一 个 Android 应 用 程序 .事件 处 理 是 必 不 可 少 的 。 前 面 章节 中 介绍 了 界面 布局 
和 控件 ,各 控件 会 被 添加 相应 的 事件 .在 界面 中 ,要 实现 人 机 pp 
交互 ,需要 触发 各 控件 上 的 事件 ,以 实现 各 种 操作 。 例 如 .用 
户 在 使 用 手机 时 ,根据 自己 使 用 的 语言 ,需要 在 手机 常用 设 | [wowsx 
置 中 设置 语言 .如 图 6-1 所 示 .在 列表 中 有 “简体 中 文 “ 繁 体 | wsx 
中 文 ”、English 等 三 个 选项 ,用 户 可 以 单 击 选 项 选择 自己 想 | Eo 
要 的 语言 。 假 设 用 户 想 使 用 “简体 中 文 ”. 用 户 单 击 “ 简 体 中 
文 "选项 后 ,会 触发 列表 选项 上 的 事件 .系统 监听 到 事件 后 ， 
会 进行 响应 和 处 理 . 这 时 .手机 上 的 文字 就 会 以 “简体 中 文 ” 
的 字体 显示 出 来 

Android 系统 中 .事件 处 理 机 制 有 两 种 . 一 种 是 基于 监听 的 事件 机 制 , 另 一 种 是 基于 
回调 的 事件 处 理 机 制 。 基于 监听 事件 的 处 理 机 制 主要 涉及 三 类 对 象 .具体 如 下 。 

(1) 事件 源 (Event Source) : 事件 源 指 的 是 事件 所 发 生 的 控件 ,如 按钮 和 列表 等 。 各 
个 控件 在 不 同情 况 下 触发 的 事件 不 尽 相同 。 例 如 ,在 图 6-1 中 .列表 就 是 事件 源 。 

(2) 事件 (Event) : 事件 封装 了 特定 事件 的 具体 信息 .事件 是 事件 源 和 事件 监听 器 的 
中 介 。 
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(3) 事件 监听 器 (Event Listener) : 负责 监听 事件 是 否 到 来 ,一旦 所 关心 的 事件 发 生 ， 
则 把 事件 提交 给 事件 处 理 方法 进行 处 理 。 

下 面 结合 监听 事件 的 处 理 模型 图 ,如 图 6-2 所 示 , 分 析 事件 处 理 的 过 程 : 首先 需要 为 事 
件 源 对 象 添加 、 注 册 事 件 监 听 器 :这样 当 某 个 事件 被 触发 后 . 才 会 被 相应 的 事件 监听 器 监听 
到 ,并 调用 相应 的 事件 处 理 器 来 处 理 该 事件 。 当 事件 源 上 的 事件 被 触发 时 ,系统 会 生成 相应 
的 事件 对 象 ,并 把 该 事件 对 象 传送 给 注册 到 该 事件 源 的 监听 器 。 事 件 监听 器 接收 到 事件 对 
象 后 ,系统 会 调用 监听 器 中 相应 的 事件 处 理 方法 来 处 理 该 事件 .并 做 出 相应 的 响应 。 





















































事件 
3. 生成 事件 对 象 
ee 事件 对 象 事件 源 
4 触发 | 用 户 操作 [二 各 发 了 事 古 “| (被 监 听 的 对 象 )| 处 理 器 
源 上 的 事件 Tt 
1 为 事件 源 注册 监听 EU 
5. 调用 对 应 的 事件 处 理 | 
方法 ， 做 出 相应 的 响应 
和 操作 事件 处 理 方法 











6-2 监听 事件 的 处 理 模 型 


基于 监听 器 的 事件 处 理 机 制 是 一 种 委派 式 的 事件 处 理 方式 ,事件 源 将 整个 事件 委托 
给 事件 监听 器 ,由 监听 器 对 事件 进行 响应 处 理 , 这 种 处 理 方式 将 事件 源 和 事件 监听 器 分 
离 , 有 利于 提供 程序 的 可 维护 性 。 
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SL4A 提供 了 相关 函数 用 来 管理 事件 .这 些 函 数 的 功能 主要 是 向 事件 队列 中 投递 事 
件 以 及 从 事件 队列 中 删除 事件 和 取出 事件 .下面 介 绍 事件 函数 。 


eventClearBuffer () 
该 函数 用 于 清除 事件 缓冲 区 中 的 所 有 事件 。 
eventPoll (Integer number_of_events) 


该 函数 用 于 从 事件 缓冲 区 中 获取 投递 时 间 最 久 的 若干 事件 .事件 将 从 事件 缓冲 区 中 
删除 ,事件 数量 由 参数 number_of_events 指定 .number_of_events 默认 值 为 1 ,该 参数 是 
可 选 的 ,函数 以 键 值 列表 方式 返回 事件 。 


eventPost (String name, String data, Boolean enqueue) 


该 函数 用 于 将 某 一 事件 投递 到 事件 队列 中 .参数 name 表示 事件 名 .参数 data 表示 事 
件数 据 .参数 enqueue 是 布尔 值 .其 值 为 false 表明 只 分 发 事件 而 不 把 事件 投递 到 事件 队 
列 中 ,其 值 为 true 表示 事件 要 投递 到 事件 队列 中 ,默认 值 是 false, 该 参数 是 可 选 的 。 


eventWait (Integer timeout) 


ms | 
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该 函数 用 于 等 待 事件 .参数 timeout 表示 最 大 等 待 时 间 ,等 待 时 间 的 单位 是 ms, 该 参 
数 是 可 选 的 。 该 函数 可 能 出 现 以 下 几 种 情况 。 

(1) 如 果 在 指定 等 待 时 间 内 没有 事件 . 则 函数 将 以 堵塞 方式 运行 直到 等 待 时 间 结 束 ; 

(2) 如 果 在 指定 等 待 时 间 范 围 内 有 事件 . 则 函数 返回 事件 ,并 把 该 事件 从 缓冲 区 中 
删除 ; 

(3) 如 果 未 指定 timeout 则 一 直 等 待 ,直到 有 事件 到 来 ,函数 返回 等 到 的 事件 ; 

(4) 如 果 timeout 值 为 0 则 表示 不 等 待 。 

下 面 通过 实例 6-1 描述 文件 下 载 事 件 处 理 , 该 例 模拟 了 文件 下 载 并 显示 文件 下 载 进 
度 , 它 同 时 扮演 了 事件 源 和 事件 监听 器 两 个 角色 ,通过 eventPost() 函数 投递 事件 ， 
eventWait() 函 数 监 听 事 件 。 该 例 流程 图 如 图 6-3 所 示 。 


1 
通过 函数 eventPost() 投 递 事件 ， 
事件 名 为 DownloadProgress 
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通过 函数 eventWait0) 监 听 事 件 
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图 6-3 文件 下 载 事件 流程 图 
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【 例 6-1】 (代码 位 置 ; \6\event\test. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”): 


var droid= new Android(); 


droid. dialogCreateHorizontalProgress(“ 文 件 下 载 “, “正在 下 载 ,请 等 待 . ..“); 

droid. dialogShow() ; 

var items= (Math. random() * 10) |0; // 随 机 生成 0 10 的 值 ,模拟 文件 下 载 进度 值 
droid. eventPost (“DownloadProgress”, items. toString(), true); 

/* 将 事件 DownloadProgress 投递 到 事件 队列 中 , 其 携带 的 数据 是 文件 下 载 进度 值 * / 
var flag= true; 

while (flag) 


{ 
var ret= droid. eventWait () ; // 监 听 等 待 事件 
Switch (ret.name ) 
{ 
case “DownloadFinish”: flag=false; break; // 下 载 结束 事件 处 理 
case “DownloadProgress”: // 正 在 下 载 事件 处 理 
items=parseInt (ret. data) ; 
droid. dialogSetCurrentProgress(items) ; 
break; 
default: flag=false; break; // 其 他 事件 处 理 
} 
items+= (Math. random() * 10) |0; // 累 计 下 载 进度 
if (items> 100) // 进 度 值 大 于 100 时 ,说 明 下 载 已 完成 
droid. eventPost (“DownloadFinish”,””, true); // 投 递 事件 DownloadFinish 
else 
// 投 递 事件 DownloadProgress 
droid. eventPost (“DownloadProgress”, items. toString(), true) ; 
T 


droid. dialogDismiss(); 


把 文件 test. js 复制 到 手机 或 模拟 器 中 的 /sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 


test.js, 这 时 屏幕 上 会 弹出 一 个 水 平 进度 条 对 话 框 ,显示 正在 进行 文件 下 载 .并 且 实 时 地 
显示 文件 下 载 进度 ,下载 完成 后 .进度 条 将 消失 。 本 例 中 .如果 调 用 函数 eventPost() 时 ， 
第 三 个 参数 值 由 true 改 为 false. 那 么 会 发 现 进 度 条 并 不 会 前 进 , 因 为 这 时 函数 eventPost 
并 没有 把 等 待 事件 投递 到 事件 队列 中 ,函数 eventWait 从 事件 队列 中 将 读 不 到 事件 。 


6.3 事件 数据 结构 


系统 提供 的 标准 事件 包含 事件 名 称 (name)、 事 件 附加 数据 (date) 和 事件 产生 时 间 


(time) 等 属性 ,对 不 同事 件 . 它 们 的 名 称 、 附 加 数据 和 时 间 都 将 不 同 .特别 是 属性 data. 它 
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可 以 以 值 的 形式 和 以 对 象 的 形式 来 封装 数据 . 当 以 对 象 的 形式 封闭 事件 时 .对 不 同名 称 的 
事件 ,data 对 象 中 的 属性 名 将 不 同 。 

单 击 不 同 的 控件 ,所 产生 事件 的 名 称 (name) 是 不 同 的 ,例如 , 单 击 按钮 控件 .所 
产生 的 事件 名 称 name 为 “click”, 单 击 列表 选项 时 .所 产生 的 事件 名 称 name 为 
“itemclick” 。 

根据 不 同类 型 的 按钮 ,产生 的 单 击 事件 “click” 所 附带 的 数据 Data 格式 也 会 不 
同 , 下 面 分 析 常 见 按钮 产生 事件 “click” 对 应 的 Data 格式 ,具体 如 表 6-1 至 表 6-6 
所 示 。 

表 6-1 Button 类 型 对 应 的 Data 格式 
属 性 id type visibility text 
含义 和 什 按钮 标识 符 Button 0 或 1 按钮 文本 





表 6-2 ImageButton 类 型 对 应 的 Data 格式 
属 性 id type visibility 
含义 和 值 标识 符 ImageButton 0 或 1 





表 6-3 RadioButton 类 型 对 应 的 Data 格式 





属 性 id type visibility text checked 
含义 和 值 标识 符 RadioButton 0 或 1 按钮 文本 true 或 false 





表 6-4 CheckBox 类 型 对 应 的 Data 格式 





属 性 id type visibility text checked 
含义 和 值 标识 符 CheckBox 0 或 1 按钮 文本 true 或 false 


表 6-5 ToggleButton 类 型 对 应 的 Data 格式 




















属 性 id type visibility text checked 
含义 和 值 标识 符 ToggleButton 0 或 1 按钮 文本 true 或 false 





表 6-6 ”DatePicker 和 TimePicker 类 型 对 应 的 Data 格式 
属 性 id type visibility 
含义 和 值 标识 符 NumberPickerButton 0 或 1 





以 上 表格 中 .属性 id 表示 按钮 的 id 号 :属性 type 表示 按钮 的 类 型 ;属性 text 表示 
按钮 上 显示 的 文本 ;属性 visibility 表示 按钮 是 否 可 见 . 值 为 0 表示 不 可 见 . 值 为 1 表 
示 是 可 见 的 ;属性 checked 表示 按钮 是 否 选中 . 值 为 true 表示 选中 . 值 为 false 表示 没 
选中 。 

注意 : TimePicker 控件 有 一 个 “上 午 " 或 下午” 按钮 . 当 单 击 该 按钮 时 ,返回 的 事件 和 
普通 按钮 产生 的 事件 一 样 .不 同 的 是 .按钮 文本 是 上午" 或 下午”。 
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用 户 单 击 ListView 列表 选项 时 .所 产生 的 事件 名 为 itemclick .itemclick 所 附加 的 数 
据 格式 如 表 6-7 所 示 。 
表 6-7 ListView 的 Data 格式 





属 性 id type visibility position 
含义 标识 符 ListView 0 或 1 选中 项 位 置 

















表格 中 .属性 id 表示 列表 的 id 号 ;属性 type 表示 控件 的 类 型 ;属性 visibility 表示 控 
件 是 否 可 见 . 值 为 0 表示 不 可 见 . 值 为 1 表示 是 可 见 的 ;属性 position 表示 被 选中 选项 在 
列表 数组 的 位 置 。 

SL4A 为 按键 设置 了 事件 key, 当 按键 被 按 下 去 之 后 且 按键 的 系统 行为 已 被 覆盖 ,就 
会 触发 事件 key 发 生 ,key 所 附加 的 data 数据 格式 如 表 6-8 所 示 。 


表 6-8 key 的 Data 格式 
属性 action key 





含义 键 值 


Android 中 ,系统 为 每 个 按键 分 配 了 一 个 键 值 , 系统 通过 键 值 来 识别 按键 ,Android 
按键 与 键 值 对 应 关系 如 表 6-9 所 示 。 


表 6-9 按键 名 与 键 值 对 应 表 


















































键 名 描 述 键 值 备 注 
KEYCODE_HOME HOME 按键 3 
KEYCODE_BACK 返回 键 4 
KEYCODE_CALL 拨号 键 5 
KEYCODE_ENDCALL 挂机 键 6 
KEYCODE_VOLUME_UP 音量 增加 键 24 
KEYCODE_ VOLUME_DOWN | 音量 减 小 键 25 

电话 键 | KEYCODE_ POWER 电源 键 26 
KEYCODE_ CAMERA 拍照 键 27 
KEYCODE_ FOCUS 拍照 对 焦 键 80 
KEYCODE_MENU 菜单 键 82 
KEYCODE_NOTIFICATION 通知 键 83 
KEYCODE_SEARCH 搜索 键 84 
KEYCODE_ MUTE 话 简 静 音 键 91 
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续 表 
键 名 描 述 键 值 备 注 
KEYCODE_DPAD_UP 导航 键 向 上 19 
KEYCODE_DPAD DOWN 导航 键 向 下 20 
KEYCODE_DPAD LEFT 导航 键 向 左 中 
KEYCODE_DPAD_RIGHT 导航 键 向 右 22 
KEYCODE_DPAD_CENTER 导航 键 确定 键 23 
KEYCODE_TAB Tab 键 61 
KEYCODE_ENTER 回 车 键 66 
KEYCODE DEL 退 格 键 67 
KEYCODE_PAGE_UP 向 上 翻 页 键 92 
KEYCODE_ PAGE_DOWN 向 下 翻 页 键 93 
控制 键 | KEYCODE_ESCAPE Esc 键 111 
KEYCODE_FORWARD DEL 删除 键 112 
KEYCODE_CAPS LOCK 大 写 锁定 键 115 
KEYCODE, SCROLL_ LOCK 滚动 锁定 键 116 
KEYCODE_BREAK Break/Pause 键 121 
KEYCODE_MOVE_HOME 光标 移动 到 开始 键 | 122 
KEYCODE_MOVE_END 光标 移动 到 末尾 键 | 123 
KEYCODE_INSERT 插入 键 124 
KEYCODE_ NUM_LOCK 小 键盘 锁 143 
KEYCODE_ZOOM_IN 放大 键 168 
KEYCODE_ZOOM_OUT 缩小 键 169 
KEYCODE 0 按键 0 7 按键 0 的 键 值 为 7 ,按键 
数字 键 |KEYCODE 1 按键 1 8 1 的 键 值 为 8, 以 此 类 
KEYCODE 9 按键 9 16 准 : 芒 全 的 乱入 为 16 
KEYCODE_A 按键 A 29 CE 
类 推 .按键 Z 的 键 值 为 
字母 键 | KEYCODE B 按键 B 30 ee 
_CAPS_LOCK 键 进行 大 
KEYCODE Z 按键 Z 5 | 小 号 要 后; 扩 后 竺 入 相 
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64 事件 处 理 


6.4.1 菜单 事件 处 理 


用 户 在 使 用 菜单 时 ,每 个 菜单 选项 都 能 完成 特定 的 功能 ,用 户 单 击 菜单 选项 时 ,会 触 
发 选项 上 的 事件 ,并 产生 事件 对 象 .系统 监听 到 事件 对 象 后 ,会 调用 相应 的 事件 处 理 方法 
进行 响应 处 理 , 完 成 相应 的 功能 。 

下 面 通过 实例 6-2 说 明 菜单 事件 处 理 ,该 例 中 可 以 通过 单 击 菜单 选项 ,触发 选项 上 的 
事件 ,从 而 实现 对 文本 进行 复制 .粘贴 和 设置 字体 颜色 等 功能 。 本 例 包 含 两 个 文件 ,一 个 
是 界面 文件 mylayout. xml, 另 一 个 是 JavaScript 文件 test. js。 

【 例 6-2】 (代码 位 置 : \6\menuevent) 

文件 mylayout. xml: 


《2?xml version= “1.0”encoding= “utf- 8”?> 
《LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout_width= “fill_parent” 
android:layout height= “fill parent” 
android:background= “#000000” 
>《“!-- 描 述 一 个 垂直 线性 布局 --> 
《TextView 
android:text= “本 例 中 通过 单 击 菜单 选项 , 触发 选项 上 的 事件 , 从 而 实现 对 文本 进行 复制 、 
粘贴 和 设置 字体 颜色 等 功能 .7 
android:layout width= “fill_parent” 
android:layout_height=“120px” 
android:layout_gravity= “center” 
/2《!-- 在 垂直 线性 布局 中 添加 一 个 TextView 控件 --> 
《EditText 
android:layout_width=”fill_parent“ 
android:layout_height= ”120px ” 
android:layout_ gravity= center” 
android:gravity=“center” 
android:inputType= “text” 
android:id=“"@+id/editText1” 
android:text=“ 你 可 在 此 文本 编辑 框 输 入 文本 !” 
/2《 !-- 在 垂直 线性 布局 中 添加 一 个 EditText 控件 -一 > 
< TextView 
android:text=“ 此 文本 框 显示 复制 .粘贴 操作 后 的 文本 内 容 .” 
android:layout width=” fill parent ” 
android:layout height=“120px ” 
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文件 test.js: 





第 (6 守 事件 咖 应 外 型 


break:; 
default: 


break; 
} 


ret= droid. eventWait (10000); 


function file get_ contents (fileName) { 
var file=new java. io.File(fileName); 
var reader= new java. io. BufferedReader (new java. io. FileReader (file)):; 
var tempString=null; 
var fileString=""; 
/ 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close(); 
return fileString; 


} 


在 布局 文件 mylayout. xml 中 ,首先 描述 了 一 个 垂直 线性 布局 ,然后 在 该 线性 布局 中 
从 上 到 下 依次 添加 了 一 个 TextView 控件 ,一 个 EditText 控件 和 另 一 个 TextView 控件 。 

在 文件 test.js 中 .通过 调用 函数 eventWait() 来 监听 事件 . 当 监 听 到 事件 为 copy 时 ， 
对 文本 进行 复制 操作 . 当 监 听 到 事件 为 paste 时 ,进行 粘贴 操作 , 当 监 听 到 事件 为 setColor 
时 ,进行 设置 字体 颜色 操作 。 

程序 运行 之 前 . 先 把 文件 mylayout. xml 和 文件 test. js 复制 到 手机 或 模拟 器 中 的 
sdcard/sl4a/scripts/ 目 录 , 然 后 再 运行 test. js, 屏 幕 上 从 上 往 下 包含 一 个 文本 显示 框 ,一 
个 文本 编辑 框 和 另 一 个 文本 显示 框 . 用 户 可 先 在 文本 编辑 框 中 输入 文本 .然后 单 击 菜单 按 
键 时 ,屏幕 底部 会 弹出 菜单 选项 ,如 图 6-4(a) 所 示 . 用 户 可 以 选择 菜单 项 进行 相应 的 操作 。 
假如 ,用 户 在 文本 编辑 框 中 输入 的 文本 为 "Hello world!”, 然 后 依次 单 击 菜单 中 的 “复制 ” 
“粘贴 ”选项 .这 时 会 把 文本 “Hello world!" 复 制 、. 粘 贴 到 第 二 个 文本 框 , 第 二 个 文本 框 中 
也 会 显示 “Hello world!”,. 如 图 6-4(b) 所 示 。 用 户 还 可 以 单 击 菜单 项 “设置 红色 ”或 “设置 
蓝 色 ” 对 第 二 个 文本 框 进行 字体 颜色 设置 .用 户 单 击 菜单 项 “退出 .可 以 退出 程序 。 


6.4.2 按钮 事件 处 理 


用 户 在 使 用 按钮 控件 时 . 当 按 钮 被 单 击 .会 触发 按钮 上 的 事件 ,并 产生 单 击 事件 ,事件 
名 为 “click”, 系 统 监听 到 单 击 事件 click 后 ,会 调用 相应 的 事件 处 理 方法 进行 响应 处 理 , 完 
成 相应 的 功能 。 根 据 不 同类 型 的 按钮 ,产生 的 单 击 事件 click 所 附带 的 数据 Data 格式 也 
会 不 同 , 如 表 6-1 一 表 6-6 所 示 。 

下 面 通过 实例 6-3 说 明 按 钮 事件 处 理 . 例 中 包含 三 个 Button 按钮 和 一 个 CheckBox 
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按钮 ,每 个 按钮 都 包含 相应 的 事件 , 单 击 不 同 的 按钮 都 会 触发 按钮 上 的 事件 ,产生 不 同 的 
事件 ,程序 会 对 事件 进行 判断 并 进行 相应 的 处 理 ,第 一 个 Button 按钮 用 于 在 文本 框 中 显 
示 内 容 ,第 二 个 Button 按钮 用 于 在 编辑 框 中 输入 内 容 .第 三 个 Button 按钮 用 于 退出 程 
序 ,CheckBox 按钮 用 于 把 编辑 框 中 的 内 容 显 示 到 文本 框 中 





Pr 








立 事件 前 (b) 响应 事件 及 


图 6-4 菜单 事件 


(a) 


【 例 6-3〗 《代码 位 置 : \6\buttonevent) 
文件 mylayout. xml: 


< ?xml version= ”1.0” encoding= “utf- 8”?> 
<LinearLayout xmlns:android= “http://schemas. android. com/apk/res/android” 
android:id="@+id/background” 
android:orientation= “vertical” android:layout width= “match_parent” 
android:layout_height= “match_parent” 
android:background= “# ff000000”> // 描 述 一 个 垂直 线性 布局 
<LinearLayout android:layout width=“match parent” 
android:layout_height=“wrap_content” 
android:orientation= “horizontal” android:id=“@+id/linearLayout1”> 
<Button android:id=“@+id/button1” 
android:layout width=“wrap_content” 
android:layout_height= “wrap_content” 
android:layout weight=“1” 
android:text= “显示 文本 框 中 内 容 ^> 
< /Button> 
<Button android:id=“@+ id/button2” 
android:layout width= “wrap_content” 
android:layout_height= “wrap_content” android:1layout_ weight=“1” 
android:text= “显示 编辑 框 中 内 容 ^> 
< /Button> 
“Button android:id=“@+id/button3” 


android:layout width= “wrap_content” 
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droid. fullSetProperty(“editTextl“, “text”, “编辑 文本 ”); 
if (id==“button1” ) 
droid. fullSetProperty("textView1”, “text”, “文本 显示 ”); 
if (id==“checkBox1” ) 
{ 
var ret= droid. fullQueryDetail (“editText1”); 
droid. fullSetProperty(“textViewl1”, “text”,“ 文 本 输入 为 : “+ret. text); 


function file_ get_contents (fileName) { 
var file=new java. io.File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=""; 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close(); 
return fileString; 


} 


在 程序 中 ,循环 调用 函数 eventWait() 不 断 地 监听 事件 , 当 监 听 到 click 事件 : 如 果 事 
件 的 id 为 buttonl 时 .文本 框 中 会 显示 文本 内 容 “ 文 本 显示 ”; 如 果 事 件 的 id 为 button2 
时 ,编辑 框 中 显示 文本 内 容 “* 编 辑 文本 ”. 并 且 可 以 修改 文本 内 容 ; 如 果 事 件 的 id 为 
button3 时 ,程序 将 退出 ;如 果 事 件 的 id 为 checkBoxl 时 .编辑 框 中 输入 的 文本 将 显示 到 
文本 框 中 。 

程序 运行 后 ,屏幕 顶部 从 左 到 右 会 显示 三 个 按钮 控件 ,按钮 下 面 是 一 个 文本 显示 框 ， 
文本 框 下 面 是 一 个 文本 编辑 框 ,文本 编辑 框 下 面 是 一 个 CheckBox 按钮 控件 .用 户 单 击 按 
钮 会 产生 事件 。 当 用 户 单 击 第 一 个 按钮 时 .在 文本 框 中 会 显示 “文本 显示 ” ,运行 结 果 如 
6-5(a) 所 示 ; 当 用 户 单 击 第 二 个 按钮 时 .在 文本 编辑 框 中 显示 “编辑 文本 ” ,运行 结果 如 
图 6-5(b) 所 示 . 并 且 可 以 在 文本 编辑 框 中 修改 文本 内 容 . 例 如 输入 的 内 容 为 
“123456789”, 当 用 户 单 击 CheckBox 按钮 时 .文本 框 中 会 显示 “文本 输入 内 容 为 : 
123456789”, 运 行 结 果 如 图 6-5(c) 所 示 ; 当 用 户 单 击 第 三 个 按钮 时 .会 结束 程序 。 


6.4.3 列表 事件 处 理 


用 户 单 击 ListView 列表 选项 时 .会 触发 选项 上 的 事件 .产生 选项 单 击 事件 .事件 名 为 
“itemclick”, 系统 监听 到 事件 后 .会 进行 相应 的 响应 。itemclick 事件 所 附加 的 数据 格式 如 
表 6-7 所 示 。 

下 面 通过 实例 6-4 说 明 列 表 事件 处 理 : 例 中 首先 弹出 一 个 列表 选项 供用 户 单 击 选择 
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123456789 


框 显示 编辑 框 输入 的 
( 先 在 编辑 框 中 输 





(a) 单 击 第 一 个 按钮 (©) 单 击 CheckBox 按 钮 


用 户 单 击 列表 选项 后 .会 显示 用 户 选择 的 选项 。 
【 例 6-4】 (代码 位 置 : \6\listevent) 
文件 mylayout. xml: 


《?xml version=“1.0” encoding= “utf- 8”?> 
<LinearLayout 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:id=“@+id/LinearLayout01” 
android:layout width= “fill_ parent” 
android:layout_height= “fill_parent” 
>《 1!-- 描 述 一 个 线性 布局 -一 > 
<ListView 
android:layout_width= “wrap_content” 
android:layout_height= “wrap_content” 
android:id=“@+id/ListView01” 
android:drawSelectorOnTop= “false” 
android:background= “file:///sdcard/sl4a/scripts/earth. jpg” 
/>《!-- 在 线性 布局 中 添加 一 个 ListView 控件 -一 > 
< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var layout=file get_contents(”/sdcard/sl4a/scripts/mylayout. xml1”); 
// 获 得 要 显示 的 界面 布局 
droid. fullShow (layout); 


var mylist=new Array() ; 

mylist[0]= “广州 “; 

mylist[1]= 深圳”; 

mylist[2]= “海口 

droid. fullSetList (“ListView01”, mylist); 
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var event= droid. eventWait (8000) ; 

droid. fullDismiss(); 

var item= event. data; 

item= item. position; 

droid. dialogCreateAlert (“列表 选择 项 提示 ”, “您 点 击 了 第 “+ item+ “选项 : “+mylist[item]); 
droid. dialogSetPositiveButtonText (“确定 ):; 

droid. dialogSetNegativeButtonText ("退出 “); 

droid. dialogShow () ; 

droid. dialogGetResponse(); 


function file get_contents (fileName) { 
var file=new java. io.File(fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“” 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


} 


在 文件 test.js 中 .定义 了 一 个 列表 ,包含 三 个 选项 ,通过 调用 eventWait( ) 监 听 事 件 ， 
如 果 在 8s 内 单 击 列表 选项 . 则 监听 到 事件 .得 到 用 户 的 选项 。 程 序 运行 之 前 , 先 把 文件 
mylayout. xml、 文 件 test. js 和 图 片 earth. jpg 复制 到 手机 或 模拟 器 中 的 /sdcard/sl4a 
scripts/ 目录 ,然后 再 运行 test. js, 屏 幕 上 会 出 现 一 个 列表 选项 .用户 可 以 单 击 选项 进行 选 
择 ,假如 用 户 单 击 选项 “深圳 ”, 这 时 ,屏幕 上 会 弹出 一 个 警告 对 话 框 ,提示 用 户 选 择 的 选 
项 。 程 序 运行 结果 如 图 6-6 所 示 . 






列表 选择 项 提示 


您 点 击 了 第 1 选项 :深圳 





(a) 列表 选项 (b) 选项 提示 对 话 框 
6-6 ”列表 事件 
6.4.4 键盘 事件 处 理 


用 户 在 使 用 手机 时 .经 常 需要 通过 手机 键盘 输入 数字 、 文 本 等 信息 ,还 可 以 通过 键盘 
控制 手机 功能 ,如 通过 键盘 按键 拨打 和 挂 断 手机 通话 、 通 过 键盘 按键 调节 手机 的 音量 
这 些 应 用 都 是 通过 键盘 事件 来 实现 的 。 在 Android 中 .提供 了 键盘 事件 (keyevent) ,包括 


128 


第 (6 塞 吉 件 响应 外 型 


按 下 事件 (KeyDown) 、 弹 起 事件 (KeyUp) 等 , 当 按 下 键盘 按键 时 ,会 触发 按键 上 相应 的 事 
件 , 系 统 会 对 该 事件 进行 相应 处 理 。 

下 面 通过 实例 6-5 说 明 键 盘 事 件 处 理 . 例 中 通过 一 个 开关 按钮 关闭 或 打开 声音 按键 
默认 行为 , 当 按钮 开关 打开 时 ,用 户 可 以 通过 键盘 音量 增加 键 和 音量 减 小 键 调 整 音量 大 
小 , 当 按 钮 开关 关闭 时 ,将 禁止 通过 键盘 音量 增加 键 和 音量 减 小 键 调整 音量 大 小 。 

【 例 6-5】 (代码 位 置 : \6\keyevent) 


文件 mylayout. xml: 


《<?xml version= “1.0” encoding= “utf- 8”?> 
《LinearLayout xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout_width= "fill parent” android:layout_ height= “fill parent” 
android:background=“# 000000” 
>《!-- 描 述 一 个 垂直 线性 布局 -一 > 
< TextView 
android:text= “通过 按 模拟 器 键盘 上 的 声音 调整 按键 观察 是 否 会 跳出 声音 调整 窗口 ,用 以 
测试 通过 开关 按钮 控制 声音 调整 按钮 .” 
android:layout width=“wrap_content” 
android:layout height=“wrap_content” 
/2《 !-- 在 垂直 线性 布局 中 添加 一 个 TextView 控件 -一 > 
<ToggleButton 
android:id=“@+id/mytogglebutton” 
android:layout width= “fill parent” 
android:layout_height=“wrap_content” 
android:text0n= “按键 调整 音量 大 小 功能 已 打开 
android:text0ff= “按键 调 整 音量 大 小 功能 已 关闭 ” 
android:checked= “true” 
>《!-- 在 垂直 线性 布局 中 添加 一 个 ToggleButton 控件 -一 > 
< /ToggleButton> 
< Button 
android:text= “退出” 
android:layout width= “fill_parent” 
android:layout_height= “wrap_content” 
android:id=“@+id/mybutton” 
>《 !-- 在 垂直 线性 布局 中 添加 一 个 Button 控件 -一 > 
< /Button> 
< /LinearLayout> 


文件 test. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”):; 
var droid= new Android(); 
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在 布局 文件 mylayout. xml 中 ,描述 了 一 个 垂直 线性 布局 ,在 该 垂直 线性 布局 中 从 上 
到 下 依次 添加 了 一 个 TextView 控件 .一 个 ToggleButton 控件 (id 为 "mytogglebutton")， 
一 个 Button 控件 。 

在 文件 test. js 中 .调用 eventWait() 监 听 事 件 . 当 监 听 到 事件 为 click 并 且 id 为 
mytogglebutton 时 . 则 调用 函数 fullQueryDetail() 查 询 mytogglebutton 的 属性 。 

当 查 询 到 属性 checked 值 为 true 时 ,表示 开关 按钮 是 打开 状态 ,这 时 定义 一 个 按键 数 
组 ,并 把 按键 键 值 赋值 给 数组 : $ keys[0] 一 24 表示 该 键 是 键盘 音量 增加 键 , $keys[1] 一 
25 表示 该 键 是 键盘 音量 减 小 键 , 然 后 调用 函数 fullKeyOverride( $ keys,false) 打 开 键 盘 
按键 默认 行为 .表示 通过 这 两 个 键 可 以 调整 音量 大 小 ; 当 查询 到 属性 checked 值 不 是 true 
时 ,表示 开关 按钮 是 关闭 状态 .调用 函数 fullKeyOverride($ keys,true) 关 闭 键 盘 按键 默 
认 行 为 ,表示 这 两 个 键 不 能 调整 音量 大 小 。 

程序 运行 后 ,屏幕 从 上 到 下 依次 显示 一 个 文本 信息 ,一 个 开关 按钮 ,一 个 “退出 ”按钮 。 
用 户 可 以 单 击 开关 按钮 控制 是 否 可 以 通过 声音 调整 按键 调整 音量 大 小 : 当 开关 按钮 处 于 
打开 状态 时 ,用 户 单 击 模拟 器 上 的 键盘 音量 增加 键 和 音量 减 小 键 ,系统 会 跳出 声音 调整 窗 
口 , 这 时 用 户 可 以 通过 按键 调整 声音 大 小 .如 图 6-7(a) 所 示 : 当 开 关 按 钮 处 于 关闭 状态 时 ， 
用 户 单 击 模拟 器 上 的 键盘 音量 增加 键 和 音量 减 小 键 , 系 统 不 会 跳出 声音 调整 窗口 ,这 时 键 
盘 按键 默认 行为 被 关闭 ,用 户 不 能 通过 按键 调整 声音 大 小 :如 图 6-7(b) 所 示 。 用 户 单 击 
“退出 ”按钮 可 以 退出 程序 。 


基 ell 外 10:50 


按键 调整 音量 大 小 功 乱 已 关闭 


(a) 开关 打开 时 ， 音 量 键盘 事件 (b) 开关 关闭 时 ， 音 量 键 盘 事 件 


6-7 键盘 事件 





6.4.5 其 他 事件 处 理 


Android 中 .每 个 按键 都 有 一 定 的 功能 . 单 击 后 会 产生 按键 事件 。 但 是 .开发 人 员 有 
时 可 以 通过 覆盖 按键 事件 .来 改变 按键 系统 的 默认 行为 .并 且 给 予 按键 新 的 行为 功能 。 例 
如 .可 以 通过 覆盖 按键 事件 .覆盖 声音 按键 默认 的 调整 声音 行为 .并 且 给 予 声音 按键 结束 
应 用 程序 的 功能 。 

下 面 通过 实例 6-6 说 明 覆 盖 声 音 按 键 行为 。 本 例 中 .通过 覆盖 按键 事件 .覆盖 声音 按 
键 行为 .并 且 给 予 按键 新 的 功能 . 连 按 声音 按键 将 结束 应 用 程序 。 

【 例 6-6】 (代码 位 置 : \6\soundOverride) 


文件 mylayout. xml: 
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// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 

while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 

} 

reader. close(); 

return fileString; 


; 


WiFi 是 一 种 可 以 将 个 人 计算 机 、 手 持 设备 (如 PAD、 手 机 ) 等 终端 以 无 线 方式 互相 连 
接 的 技术 ,已 广泛 应 用 于 人 们 的 生活 、 学 习 和 工作 中 。Android 对 WiFi 有 较 好 的 支持 , 通 
过 WiFi 上 网 可 以 节省 流量 。 而 WiFi 是 非常 耗 电 的 ,在 电量 不 足 时 ,为 了 省 电 , 通 常会 关 
闭 WiFi 或 使 WiFi 进入 休眠 状态 ,同时 WiFi 信 号 的 强 弱 直接 影响 着 上 网 的 速度 ,这 样 监 
听信 号 强度 的 变化 就 显得 尤为 重要 。 信 号 强度 的 监听 是 Android 手机 十 分 常见 的 一 个 重 
要 功能 ,根据 信号 强 弱 监 视 网 络 的 变化 以 及 做 一 些 节能 的 操作 。 

下 面 通过 实例 6-7 说 明 信 号 强度 的 监听 .本 例 中 WiFi 或 电话 信号 发 生变 化 时 触发 事 
件 sl4a, 附 加 数据 data 是 对 象 .可 根据 对 象 属性 action 中 的 值 判断 是 否 为 信号 强度 变化 
广播 。 

【 例 6-7〗 〈 代 码 位 置 : \6\signalChange. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
// 监 听信 号 强度 变化 
var category= “android. intent. action. SIG_STR”; 
var ret= droid. eventRegisterForBroadcast (category, false) ; 
sleep (1000) ; 
ret= droid. eventWait () ; 
droid. eventUnregisterForBroadcast (category) ; 
if ( (ret.name!=null) && (ret.name== "sl14a“)&& (ret. data.action==category ) ) 
{ 

// 根 据 信号 是 否 关闭 或 强度 去 做 省 能 等 操作 

// 根 据 信 号 强度 监视 网 络 变化 
} 
function sleep(sleepTime) { 

for(var start=Date. now(); Date. now() — start<=sleepTime; ) {} 


} 


Android 应 用 程序 可 能 会 需要 根据 电池 的 电量 ,充电 状态 来 改变 自己 的 行为 。 比 如 . 
GPS 是 相当 耗 电 的 .类似 这 种 耗 电 的 应 用 通常 要 监视 电池 当前 的 电量 .在 电量 达到 一 个 
下 限 的 时 候 : 应 及 时 提醒 给 用 户 . 以 根据 情况 判断 是 否 关闭 GPS。 又 比如 .通过 检查 设备 
当前 的 电池 电量 和 充电 状态 .然后 适当 改变 后 台 服 务 的 更 新 频率 .可 以 有 效 降低 电量 的 消 
耗 。 应 用 程序 的 更 新 频率 也 应 当 根据 设备 当前 的 电池 电量 和 充电 状态 来 进行 动态 调整 。 
所 以 监听 电池 的 电量 .充电 状态 是 非常 重要 的 。 
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下 面 通 过 例 6-8 说 明 电 池 的 电量 充电 状 态 的 监听 。 本 例 中 电池 电量 发 生变 化 或 充 
电线 接 通 断 开 或 USB 交流 电 充 电 发 生变 化 会 触发 事件 sl4a, 附 加 数据 data 是 对 象 .可 根 
据 对 象 属性 action 中 的 值 判断 是 否 为 充电 状态 变化 广播 。 

【 例 6-8〗 (代码 位 置 : \6\batteryChange. js) 


第 (党 
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Android 系统 为 用 户 提 供 了 偏好 设置 ,用 户 初次 使 用 Android 系统 时 会 把 语言 .输入 
法 ,移动 网 络 类 型 (2G、3G 和 4G) 和 主题 等 设置 成 自己 的 偏爱 ,系统 重启 时 会 自动 加 载 这 
些 偏好 值 而 无 须 用 户 再 次 进行 设置 。 这 种 跨 应 用 程序 执行 期 或 生命 期 且 数 据 量 偏 少 的 偏 
好 值 可 以 使 用 Android 系统 提供 的 Preference 方法 来 存 取 。Preference 直译 为 “偏好 ”， 
也 可 翻译 为 “首选 项 ”。Preference 是 Android 系统 提供 的 一 种 轻 量 级 数据 存 取 方法 , 主 
要 应 用 于 数据 比较 少 的 配置 信息 ,例如 游戏 的 音量 ,难度 和 画 质 等 配置 信息 。 首 选项 是 一 
组 由 键 值 对 "key-value”" 构 成 的 数据 集 ,. 其 值 都 是 基本 数据 类 型 ,如 整 型 . 浮 点数 . 布 尔 型 
和 字符 串 等 。 其 默认 存储 位 置 在 模拟 器 或 手机 中 的 /data/data/com. googlecode. android_ 
scripting/shared_prefs 目录 下 。 首 选项 只 能 在 同一 个 包 中 使 用 .不 同 包 之 间 是 不 能 共享 
首选 项 存储 的 数据 的 。 同 时 .首选 项 存储 的 文件 是 不 能 存储 到 SD 上 的 ,这 是 首选 项 的 一 
个 局 限 。 

SL4A 提供 了 preferences API 用 于 首选 项 数据 存储 .具体 包括 prefPutValue、 
prefGetValue 和 prefGetAll 三 种 方法 .下面 介绍 这 三 个 方法 。 


prefPutValue (String key, Object value, String filename) 


prefPutValue 用 于 存储 键 值 对 .参数 key 表示 键 名 .参数 value 表示 键 值 . 它 可 以 是 
整数 、 浮 点 数 和 字符 串 等 数据 类 型 .参数 filename 表示 存储 键 值 对 的 文件 .该 参数 是 可 选 
的 ,如 果 没 有 指定 filename 则 使 用 默认 的 共享 首选 项 文件 名 。 


prefGetValue (String key, String filename) 


prefGetValue 用 于 从 指定 文件 中 读 取 指定 键 的 值 .参数 key 表示 键 名 .参数 filename 
表示 存储 键 值 对 的 文件 .该 参数 是 可 选 的 .如 果 没 有 指定 filename 则 使 用 默认 的 共享 首 
选项 文件 名 .如 果 找 到 指定 的 键 名 则 返回 对 应 的 键 值 .否则 为 null。 


prefGetAll (String filename) 


prefGetAll 用 于 从 指定 文件 中 读 取 所 有 的 键 值 对 .参数 filename 表示 存储 键 值 对 的 
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文件 ,该 参数 是 可 选 的 ,如 果 没 有 指定 filename 则 使 用 默认 的 共享 首选 项 文件 名 。 

例 7-1 是 首选 项 范例 . 例 中 先 把 键 值 对 写 到 MyPref. xml 文件 中 .然后 再 从 该 文件 中 
读 出 键 名 为 “mykey” 的 键 值 并 显示 出 来 。 

【 例 7-1〗 (代码 位 置 ; \7\testPref. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

var key= “mykey”; 

var value= “hello”; 

var filename= “MyPref”; 

droid. prefPutValue (key, value, filename) ; 

ret= droid. prefGetValue (key, filename); 

droid. dialogCreateAlert (“程序 首选 项 演示 ( 键 : 值 ) ,key+ “:“+ret); 
droid. dialogSetPositiveButtonText (“确定 ); 

droid. dialogSetNegativeButtonText (退出); 

droid. dialogShow() ; 

droid. dialogGetResponse(); 


程序 首先 通过 函数 prefPutValue 把 键 名 为 “mykey” 和 键 值 为 "hello" 的 键 值 对 存储 
到 MyPref. xml 文件 中 .然后 再 通过 函数 prefGetValue 从 
程序 首选 项 演示 ( 键 : 值 ) 该 文件 中 读 出 键 名 为 “mykey ”的 键 值 , 并 通过 函数 
dialogCreateAlert 创建 一 个 对 话 框 把 键 值 显示 出 来 。 程 序 
运行 ,屏幕 上 会 弹出 一 个 对 话 框 ,显示 mykey 的 键 值 为 
je ”as “图 helo, 如 图 7-1 所 示 
程序 会 在 模拟 器 或 手机 中 生成 首选 项 存储 文件 
四 MyPref. xml, 存储 路 径 为 “/data/data/ com. googlecode. 
android_scripting/shared_prefs”, 文 件 MyPref. xml 内 容 如 下 所 示 。 


mykey:hello 





《<?xml version= ”1.0 encoding= "utf-8” standalone= "yes” ?> 
《map> 

“string name= “mykey”> hello< /string> 

< /map> 


例 7-2 是 登录 系统 首选 项 应 用 范例 ,用 户 登录 时 可 以 选择 记 住 或 不 记 住 用 户 名 和 密 
码 . 如 果 选 择 记 住 则 下 次 登录 时 用 户 文本 框 和 密码 框 会 直接 显示 上 次 记录 的 内 容 . 而 无 须 
用 户 再 次 输入 用 户 名 和 密码 ,如 果 选 择 不 记 住 则 下 次 登录 时 用 户 文本 框 和 密码 框 显示 空 
值 。 范 例 由 文件 preference login. xml 和 preference_login. js 组 成 .前 者 用 来 实现 UI. 后 
者 用 来 实现 业务 。UI 由 用 户 文本 框 、 密 码 框 “ 记 住 密码 " 复 选 框 和 “自动 登录 ” 复 选 框 
组 成 。 

【 例 7-2】 (代码 位 置 : \7\preference login) 

文件 preference_ login. xml: 
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文件 preference_login. js: 
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//return; 


break; 
} 


程序 运行 时 会 首先 加 载 UI. 然 后 读 取 用 户 名 、 密 码 、 记 住 密码 和 自动 登录 4 个 首选 项 
值 ,最 后 用 首选 项 值 设置 UI 用 户 名 等 输入 域 值 。 如 果 用 户 单 击 “ 登 录 ” 按 钮 就 结束 程序 ， 
结束 程序 前 会 查询 “ 记 住 密码 " 复 选 框 状态 .如 果 用 户 选择 了 该 复 选 框 , 则 保存 用 户 名 和 密 
码 到 首选 项 ,否则 对 应 首选 项 的 值 为 空 。 图 7-2 是 
范例 运行 结果 .图 中 用 户 输入 了 用 户 名 和 密码 ,以 
及 选择 “ 记 住 密码 "和 “自动 登录 ”, 用户 单 击 “登录 ” 
按钮 会 结束 应 用 程序 ,如 果 再 次 运行 程序 其 结果 依 
旧 如 图 7-2 所 示 

与 数据 库 相 比 ,首选 项 免 去 了 创建 数据 库 、 创 
建 表 和 编写 SQL 语句 等 诸多 操作 ,相对 而 言 更 加 
简便 。 但 是 首选 项 也 有 其 自身 缺陷 , 它 只 能 存储 布 
尔 、 整 型 . 浮 点 型 和 字符 串 等 简单 数据 类 型 . 它 适 用 
于 数据 量 偏 少 而 不 适用 于 数据 量 较 大 的 配置 信息 ， 
图 7-2 登录 系统 首选 项 范例 它 无 法 进行 条 件 查询 等 操作 。 首 选项 只 是 存储 的 

一 种 方式 ,无 法 完全 替代 数据 库存 储 方式 。 


7.2 SQLie 数据 库 





7.2.1 SQLite 是 什么 


SQLite 是 一 个 嵌入 式 关系 型 数据 库 引 擎 . 专 门 
为 计算 能 力 非 常 有 限 的 手机 等 设备 提供 数据 存储 服务 。SQLite 已 广泛 地 被 应 用 在 手机 、 
PDA .MP3 播放 器 以 及 机 顶 盒 等 设备 中 。Mozilla Firefox、PHP、Skype 客户 端 软件 .AOL 
邮件 客户 端 、Solaris 10、McAfee 杀毒 软件 和 iPhone 等 知名 系统 也 都 内 置 和 使 用 了 
SQLite 数据 库 。Android 系统 自身 就 内 置 有 SQLite. SQLite 是 Android 系统 的 原生 态 
服务 ,Android 手机 通信 录 等 应 用 都 基于 SQLite 存 取 数 据 。 

大 多 数 SQL 数据 库 引 擎 是 一 个 独立 的 服务 器 进程 .期望 访 问 数 据 库 的 应 用 程序 进程 
必须 通过 SQL 数据 库 引擎 服务 器 进程 来 读 写 数 据 库 文 件 . 应 用 和 引擎 服务 器 的 通信 协议 
通常 为 TCP/IP 等 协议 。SQLite 并 不 同 于 Oracle 和 MySQL 等 专业 数据 库 .SQLite 数 
据 库 只 是 一 个 文件 .从 本 质 上 来 看 .SQLite 的 操作 方式 只 是 一 种 更 为 便捷 的 文件 操作 ,或 
者 说 .应 用 程序 进程 可 以 直接 进行 SQLite 数据 库 文件 的 读 写 而 不 需要 中 间 层 的 服务 器 进 
程 。 这 样 的 主要 好 处 是 不 需要 进行 安装 .配置 .初始 化 .管理 和 维护 单独 的 服务 进程 。 
SQLite 具有 ACID(CAtomic 原子 性 .Consistent 一 致 性 .Isolated 隔离 性 .Durable 持久 性 ) 
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特性 ,这 些 特性 为 SQLite 数据 事务 性 提供 了 保障 .即使 程序 .操作 系统 和 电源 等 发 生 了 异 
常 状况 。SQLite 对 外 部 程序 库 以 及 操作 系统 的 要 求 最 低 . 这 使 得 它 非常 适合 应 用 于 典 入 
式 设备 ,同时 ,可 以 应 用 于 很 少 修改 配置 的 应 用 程序 。 

SQLite 提供 两 种 数据 操作 方式 。 一 种 是 命令 行 方式 , SQLite 包含 一 个 名 字 叫 做 
sqlite3 的 命令 行 , 它 可 以 让 用 户 手 工 输入 并 执行 面向 SQLite 数据 库 的 SQL 命令 。 另 一 
种 是 类 库 方式 ,通过 类 库 可 以 让 由 Tcl.C# .PHP 和 Java 等 语言 开发 的 应 用 操作 SQLite 
数据 。 尽 管 类 库 方式 具有 较 好 的 扩展 性 ,适用 于 多 种 开发 语言 .但 SL4A 并 没有 开放 数据 
库 接口 ,需要 为 脚本 在 Android 平台 开发 或 移植 第 三 方 数据 库 类 库 , 其 实现 和 移植 具有 较 
大 难度 。 本 文 仅 探讨 命令 行 数 据 库 编程 方式 。 


7.2.2 SQL 语法 


SQLite 和 传统 关系 型 数据 库 系 统 在 数据 存储 方面 有 较 大 差异 .SQLite 采用 的 是 动 
态 数据 类 型 ,而 其 他 传统 关系 型 数据 库 使 用 的 是 静态 数据 类 型 。 在 传统 关系 数据 库 中 , 输 
入 值 的 数据 类 型 由 它 的 存储 单元 (存储 的 字段 ) 来 决定 ,或 者 说 ,数据 库存 储 的 数据 类 型 和 
输入 值 的 数据 类 型 是 一 致 的 。 在 SQLite 中 ,输入 值 的 数据 类 型 与 值 本 身 相 关 , 而 不 是 由 
它 的 存储 单元 (存储 的 字段 ) 来 决定 ;或 者 说 .数据 库存 储 的 数据 类 型 和 数据 输入 的 类 型 是 
动态 匹配 的 ,存储 单元 (存储 的 字段 ) 的 数据 类 型 由 输入 值 的 数据 类 型 决定 ;也 可 以 理解 为 
存储 单元 本 身 是 没有 数据 类 型 的 , 它 可 以 存储 任意 数据 类 型 的 值 。SQLite3 的 动态 数据 
类 型 能 够 向 后 兼容 传统 关系 数据 库 普 遍 使 用 的 静态 类 型 .这 就 意味 着 ,在 那些 使 用 静态 数 
据 类 型 的 数据 库 上 使 用 的 数据 表 . 在 SQLite3 上 也 能 被 使 用 。 

SQLite3 支持 NULL INTEGER .REAL .TEXT 和 BLOB 等 5 种 数据 类 型 。NULL 
是 空 值 。INTEGER 是 有 符号 的 整数 ,根据 值 的 大 小 以 1.2.3.4.6 和 8 字 节 存储 。 
REAL 是 浮 点 数 .以 8 字 节 IEEE 浮 点 数 存储 。TEXT 是 文本 字符 串 . 使 用 数据 库 编码 
(UTF-8, UTF-16BE 或 UTF-16LE) 进行 存储 。BLOB 是 一 个 数据 块 , 按 输入 值 原样 
存储 。 

为 了 最 大 化 SQLite 和 其 他 数据 库 之 间 的 数据 类 型 兼容 性 .SQLite 提出 了 “类 型 亲缘 
性 (Type Affinity) ”的 概念 。 可 以 这 样 理解 “类 型 亲缘 性 ”. 在 表 字 段 被 声明 之 后 .SQLite 
都 会 根据 该 字段 声明 时 的 类 型 为 其 选择 一 种 亲缘 类 型 . 当 数 据 插入 时 :该 字段 的 数据 将 会 
优先 采用 亲缘 类 型 作为 该 值 的 存储 方式 .除非 亲缘 类 型 不 匹配 或 无 法 转换 当前 数据 到 该 
亲缘 类 型 .这样 SQLite 才 会 考虑 其 他 更 适合 该 值 的 类 型 存储 该 值 。SQLite 支持 5 种 亲 
缘 类 型 ,其 类 型 如 表 7-1 所 示 。 

SQLite 支持 的 数据 类 型 虽然 只 有 NULL INTEGER、REAL .TEXT 和 BLOB 等 
5 种 类 型 .但 “类 型 亲缘 性 ” 却 可 以 让 SQLite 接受 更 多 的 数据 类 型 .包括 布尔 值 .日 期 和 时 
间 等 数据 类 型 .只 不 过 在 运算 或 存储 时 会 转 成 对 应 的 5 种 数据 类 型 。 比 如 ,把 布尔 值 true 
转换 成 1,false 转换 成 0。 再 比如 .SQLite 内 置 的 日 期 和 时 间 函 数 能 够 将 日 期 和 时 间 转 换 
成 或 为 TEXT 或 为 REAL、 或 为 INTEGER 值 。SQLite 的 重要 特点 是 可 以 存储 任何 类 
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表 7-1 亲缘 类 型 
亲缘 类 型 描 述 
a 数值 型 数据 在 被 插入 数据 库 之 前 .需要 先 被 转换 为 文本 格式 ,之 后 再 插入 到 数据 库 目 
标 字 段 中 
当 文 本 数据 被 插入 到 亲缘 性 为 NUMERIC 的 字段 中 时 .如 果 转 换 操作 不 会 导致 数据 信息 
丢失 以 及 完全 可 道 ,那么 SQLite 就 会 将 该 文本 数据 转换 为 INTEGER 或 REAL 类 型 的 数 
RC 据 ,如 果 转 换 失败 .SQLite 仍 会 以 TEXT 方式 存储 该 数据 。 对 于 NULL 或 BLOB 类 型 的 
中 新 数据 ,SQLite 将 不 做 任何 转换 ,直接 以 NULL 或 BLOB 的 方式 存储 该 数据 。 需 要 额外 
说 明 的 是 ,对 于 浮 点 格式 的 常量 文本 ,如 “30000.0”, 如 果 该 值 可 以 转换 为 INTEGER 同时 
又 不 会 丢失 数值 信息 ,那么 SQLite 就 会 将 其 转换 为 INTEGER 的 存储 方式 
Ee 对 于 亲缘 类 型 为 INTEGER 的 字段 ,其 规则 等 同 于 NUMERIC, 唯 一 差别 是 在 执行 
”| CAST 表达 式 时 
RA 其 规则 基本 等 同 于 NUMERIC, 叭 一 的 差别 是 不 会 将 "30000. 0" 这 样 的 文本 数据 转换 为 
人 INTEGER 存储 方式 
NONE 不 做 任何 的 转换 ,直接 以 该 数据 所 属 的 数据 类 型 进行 存储 





型 的 数据 到 任何 字段 中 ,无 论 字 段 声明 的 数据 类 型 是 什么 。 例 如 ,可 以 在 INTEGER 字段 中 
存放 字符 串 ,或 者 在 TEXT 字段 中 存放 日 期 型 值 。 但 有 一 种 情况 例外 : 定义 为 INTEGER 
PRIMARY KEY 的 字段 只 能 存储 64 位 整数 , 当 向 这 种 字段 中 保存 除 整数 以 外 的 数据 时 ,将 
会 产生 错误 。 尽 管 SQLite 提供 了 这 种 方便 .但 是 一 旦 考虑 到 数据 库 平台 的 可 移植 性 问题 ， 
在 实际 的 开发 中 还 是 应 该 尽 可 能 地 保证 数据 类 型 的 存储 和 声明 的 一 致 性 。 

SQLite 可 以 解析 大 部 分 SQL92 标准 .下面 是 SQL 语句 语法 和 实例 。 

1. 建立 数据 表 

语法 : 

create table table_name (fieldl typel, field2 typel,*) 


table_name 是 要 创建 数据 表 的 名 称 ,fieldx 是 数据 表 字 段 名 称 ,typex 则 是 字段 类 型 。 
例如 ,create table student_info(stu_no interger primary key，name text) ,其 语句 含义 是 
建立 学 生 信息 表 , 它 包含 学 号 与 姓名 等 学 生 信 息 , 学 号 是 主键 。 


2. 添加 数据 记录 
语法 : 
insert into table_name (fieldl1, field2, +…) values(vall, val2,*…) 


table_name 是 表 名 ,fieldx 是 字段 名 称 ,valx 为 需要 存 入 字段 的 值 。 例 如 ,insert into 
student_info(stu_no, name) values(0001, alex” ,其 含义 是 往 学 生 信 息 表 中 添加 一 条 学 
生 记 录 , 学 号 为 0001, 姓 名 为 alex。 


3. 修改 数据 记录 


语法 : 
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update table_name set fieldl= vall, field2= val2 [where expression] 

table_name 是 表 名 ,fieldx 是 字段 名 ,valx 是 赋 给 字段 fieldx 的 值 ,expression 是 筛选 
条 件 , 条 件 是 可 选 的 ,如 果 不 指定 筛选 条 件 则 修改 所 有 数据 记录 。 例 如 .“update student 
info set name 一 hence’ where stu_no 一 0001” 的 含义 是 修改 学 号 为 0001 的 数据 记录 ,修改 
其 姓名 为 hence。 

4. 删除 数据 记录 

语法 : 

delete from table_name [where expression] 

table_name 是 表 名 ,expression 是 要 删除 数据 记录 的 筛选 条 件 , 条 件 是 可 选 的 , 如果 
不 指定 筛选 条 件 则 清空 表 中 所 有 数据 记录 。 例 如 ,delete from student_info where stu__ 
no 一 0001, 其 含义 是 删除 学 生 信息 表 中 学 号 为 0001 的 数据 记录 。 

5. 查询 数据 记录 

语法 : 

select columns from table_name [where expression] 

table_name 是 表 名 ,columns 是 字段 表达 式 ,expression 是 数据 记录 的 筛选 条 件 , 条 件 是 
可 选 的 ,如 果 不 指定 筛选 条 件 则 选择 所 有 数据 记录 。 例 如 ,“select * from table_ name” 表 示 查 
询 所 有 数据 记录 ;select x from table_name limit 3” 表 示 限 制 输出 三 条 数据 记录 ;"*select x 
from table_name order by field asc" 表 示 升 序 输出 数据 记录 ; "select x from table_name order 
by field desc” 表 示 降 序 输出 数据 记录 ; “select x from table_name where fieldx in (vall 
val2'"，val3) ”表示 字段 fieldx 值 等 于 vall"val2° 和 val3' 其 中 之 一 的 记录 ;“select count(*) 
from table_name” 表 示 查 询 记录 数目 ;“select distinct fieldx from table_name” 表 示 查 询 不 重复 
的 数据 .有 一 些 字段 的 值 可 能 会 重复 出 现 .distinct 会 去 掉 重复 项 。 

6. 建立 索引 

当 数 据 表 存 在 大 量 记录 .索引 有 助 于 加 快 查找 数据 表 速 度 。 

语法 : 

create index index_name on table name (fieldx) 

index_name 是 索引 名 ,table_name 是 表 名 . fieldx 是 字段 名 。 例如,“ create index 
student_index on student_table(stu_no)” 表 示 基 于 表 student_table 字段 stu_no 上 建立 
一 个 名 为 index student_index 的 索引 。 建 立 完 成 后 ,sqlite3 在 对 该 字段 查询 时 ,会 自动 
使 用 该 索引 。 

7. 删除 数据 表 或 索引 


删除 表 语 法 : 
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drop table table_name 
删除 索引 语法 : 


drop index index_name 


7.2.3 面向 脚本 的 SQLite3 框架 


SL4A 没有 为 脚本 提供 数据 库 开发 接口 .脚本 需 引 入 第 三 方 数据 库 编 程 组 件 才 可 以 实 
现 数据 库 编 程 。 下 面 是 基于 接口 转换 和 面向 JavaScript 脚本 的 SQLite3 框架 。 有 了 这 个 
SQLite3 框架 ,JavaScript 脚本 便 可 借助 SQL 语句 以 传统 开发 方式 实现 数据 库 编 程 。 该 框架 
提供 了 4 个 重要 方法 ,分 别 是 open .close、query 和 exec 方法 。open 和 close 方法 分 别 用 来 打 
开 和 关闭 数据 库 文件 。exec 方法 的 作用 是 执行 SQL 语句 ,一 些 没 有 返回 结果 的 SQL 语句 
可 通过 它 来 操作 数据 库 , 例 如 insert 和 update 等 SQL 语句 。query 方法 的 作用 是 执行 select 
语句 查询 数据 ,数据 以 表格 形式 返回 ,第 一 行 数据 是 字段 集 ,字段 与 字段 之 间 以 间隔 符 “|" 隔 
离 ,第 二 行 及 后 面 数 据 是 查询 数据 内 容 , 每 行 数据 表示 一 条 记录 ,记录 字段 以 间隔 符 “|" 隔 
离 。 通 过 这 些 方 法 脚本 便 可 实现 数据 库 的 CRUD( 创 建 查 询 、 更 新 和 删除 ) 操 作 。 

【 例 7-3】 (代码 位 置 : \7\SQLite. js) 


function SQLite() { 


var dbName=“; // 数 据 库 名 
this. noSuchMethod_ =function(id, args) { 
return “error”; 
} 
// 查 询 功 能 
this. query= function (arg) 
{ 
if ( dbName!="”) 
{ 
runCommand(”sh”, ”— c’”,”sqlite3 -header “+ dbName +” ””+arg+””>/sdcard/sl4a/ 
scripts/output. txt”); 
var file=new java. io.File(”/sdcard/sl4a/scripts/output. txt”); 
var fis=new java. io.FileInputStream(file); 
var read= new java. io. InputStreamReader( fis,”UTF-8” ); 
var bufferedReader=new java. io. BufferedReader (read) ; 
var lineTxt="”; 
Var response="”; 
while((lineTxt=bufferedReader. readLine()) !=null){ 
response=response+ lineTxt+“\n”; 
} 
read. close(); 
return response; 于 
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// 执 行 SQL 语句 
this. exec=function (arg) 
{ 
if ( dbName!="” ) 
runCommand(”sh”, ”— c”,”sqlite3 ~ header “+ dbName+” ””+arg+””>/sdcard/sl4a/ 
scripts/output. txt”); 
3 
// 打 开 数 据 库 
this. open= function (dbname) 
{ 
dbName= dbname; 
} 
// 关 闭 数据 库 
this. close= function() 


{ 
dbName=“”; 


7.2.4 使 用 SQL 操作 SQLite3 


下 面 是 JavaScript 数据 库 编程 范例 ,该 例 先 创 建 数据 库 文件 mydb. db 和 数据 库 表 
mytable, 表 由 字段 “username” 和 “pwd” 组 成 ,然后 再 插入 4 条 记录 ,以 及 更 新 和 删除 记 
录 , 最 后 显示 查询 内 容 。 

【 例 7-4】 (代码 位 置 : \7\testSQLite3. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


load(“/sdcard/sl4a/scripts/SQLite. js”); // 将 SQLite 框架 加 载 到 脚本 引擎 内 存 缓冲 区 
var droid=new Android(); // 创 建 Android 对 象 
var sqlite=new SQLite(); // 创 建 SQLite 对 象 


sqlite. open(”/sdcard/sl4a/scripts/mydb. db”); 

sqlite. exec(’create table mytable (username, pwd) “); 

sqlite. exec(”insert into mytable (username, pwd) values( Li’,’11111111’) ”); 
sqlite. exec(”insert into mytable (username, pwd) values( zhang’,’ aaaaaaaa’  )“) ; 
sqlite. exec(”insert into mytable (username, pwd) values( Wang’,’ 22222222’) “); 
sqlite. exec(”insert into mytable (username, pwd) values( 李 明 ’”,” 123abcde’ )“); 
sqlite. exec (“update mytable set pwd=" 00000000’ where username= zhang’” “); 
sqlite. exec(“delete from mytable where username= "Li “); 

var r=sqlite. query(”select * from mytable “); 

sqlite. close(): 

print (r); 


先 把 数据 库 框架 文件 SQLite. js 复制 到 手机 或 模拟 器 的 指定 目录 “/sdcard/sl4a/ 
scripts/”, 然 后 再 运行 程序 testSQLite3. js。 程 序 运行 结果 如 图 7-3 所 示 . 图 中 包含 4 行 


145 


Andioid 脚本 应 用 天 发 技术 
数据 .第 一 行 是 字段 集 .分 别 是 “userame” 和 “pwd” 字 段 .第 二 、 四 行 是 查询 到 的 记录 . 值 
“zhang”Wang” 和 “ 李 明 ” 对 应 字段 “username”, 值 “00000000”*22222222” 和 “123abcde” 


对 应 字段 "pwd”, 字 段 间 用 符号 "| " 隔 开 。 


Username|pwd 


zhang|00000000 
Wang|22222222 
李 明 |123abcde 





7-3 ”SQLite3 编程 


7.3 文件 持久 化 


7.3.1 JavaScript 与 Java 文件 类 


JavaScript 是 一 种 I/O 能 力 偏 弱 的 脚本 语言 ,Java 是 一 种 I/O 能 力 偏 强 的 开发 语言 。 
在 Android 中 ,JavaScript 可 以 借助 Java 的 1/0O 操作 来 实现 文件 读 写 。Java 是 一 种 面 对 
对 象 的 编译 型 语言 。 它 首先 将 源 代码 编译 成 二 进 制 字 节 码 (bytecode) ,然后 依赖 各 种 不 
同 平台 上 的 虚拟 机 来 解释 执行 字 节 码 , 从 而 实现 了 “一 次 编译 ,到 处 执行 "的 跨 平台 特性 。 
Rhino 是 JavaScript 的 一 种 基于 Java 的 引擎 ,或 者 说 ,Rhino 是 JavaScript 引擎 , 它 由 
Java 编写 实现 。Rhino 的 原始 想法 是 将 JavaScript 编译 成 Java 字 节 码 执 行 , 即 采用 编译 
执行 的 方式 。 由 于 Java 存在 垃圾 收集 ,编译 和 装载 过 程 的 开销 过 大 等 限制 ,Rhino 采用 
了 解释 执行 的 方式 。 通 过 Rhino 引擎 ,JavaScript 便 可 以 很 方便 地 访问 Java 的 包 类 库 . 从 
而 实现 JavaScript 不 能 直接 实现 的 重要 功能 ,例如 ,文件 .网 络 和 多 线程 等 。 

1/O 问题 是 任何 编程 语言 都 无 法 回避 的 问题 ,因为 I/O 是 机 器 获取 和 交换 信息 的 主 
要 渠道 。L/O 的 一 个 关键 问题 就 是 数据 写 到 何 处 ,其 中 一 个 主要 方式 就 是 将 数据 持久 化 
到 物理 磁盘 。 磁 盘 的 唯一 最 小 描述 就 是 文件 .也 就 是 说 上 层 应 用 程序 只 能 通过 文件 来 操 
作 磁 盘 上 的 数据 。 为 实现 相对 统一 和 简单 的 输入 /输出 其 操作 方式 ,Java 把 文件 .网 络 和 
键盘 等 数据 抽象 为 数据 流 ,或 者 说 ,Java 把 数据 源 ( 宿 ) 与 程序 之 间 的 数据 传输 都 抽象 表述 为 
“ 流 ”(Stream) ,传输 中 的 数据 称 为 数据 流 。 那 些 能 够 提供 数据 的 事物 ,包括 键盘 磁盘 文件 
和 网 络 接口 等 ,被 称 为 数据 源 。 数 据 宿 (Data Sink) 是 指 能 够 接收 数据 的 事物 ,可 以 是 磁盘 文 
件 、 网 络 接口 .显示 器 和 打印 机 等 外 部 设备 .也 可 认为 数据 宿 是 数据 传输 的 目的 地 。 

按照 数据 流动 的 方向 .Java 把 数据 流 分 为 输入 流 (Input Stream) 和 输出 流 (Output 
Stream) 两 类 。 输 入 流 只 能 读 不 能 写 .而 输出 流 只 能 写 不 能 读 。 这 里 站 在 程序 的 角度 来 
确定 出 入 方向 ,即将 数据 从 程序 外 部 传送 到 程序 中 谓 之 “输入 "数据 .将 程序 中 的 数据 传送 
到 外 部 谓 之 “输出 数据。 按照 数据 传输 单位 .Java 把 数据 流 划分 为 字 节 流 (Byte Stream) 
和 字符 流 (Character Stream)。 字 节 流 是 指 以 字 节 为 传输 单位 的 数据 流 . 每 次 传输 一 个 或 
多 个 字 节 。 字 符 流 是 指 以 字符 为 传输 单位 的 数据 流 , 每 次 传输 一 个 或 多 个 字符 。 根 据 数 
据 流 所 关联 的 是 数据 源 还 是 其 他 数据 流 .可 分 为 节点 流 (Node Stream) 和 处 理 流 


146 


第 总 章 数 扎 持 包 人 出 


(Processing Stream) 。 节 点 流 是 指 直接 连接 到 数据 源 的 数据 流 。 处 理 流 是 对 一 个 已 存在 
的 流 的 连接 和 封装 .通过 封装 流 的 功能 调用 实现 增强 的 数据 读 / 写 功能 .处 理 流 并 不 直接 
连接 到 数据 源 。 对 数据 流 的 每 次 操作 都 是 以 字 节 为 单位 进行 的 , 既 可 以 向 输出 流 写 入 一 
个 字 节 ,也 可 从 输入 流 中 读 取 一 个 字 节 。 显 然 效 率 太 低 ,通常 使 用 缓冲 流 (Buffered 
Stream) , 即 为 一 个 流 配置 一 个 缓冲 区 .一 个 缓冲 区 就 是 专门 传送 数据 的 一 块 内 存 。 

在 Java 程序 设计 中 .1/O 操作 是 通过 java. io 包 中 的 类 和 接口 来 实现 的 。Java 对 
java. io 包 中 的 类 名 称 具 有 统一 的 命名 惯例 .凡是 以 InputStream 或 OutputStream 结 
尾 的 类 型 均 为 字 节 流 ,凡是 以 Reader 或 Writer 结尾 的 均 为 字符 流 。InputStream 是 
所 有 表示 位 输入 流 的 类 的 父 类 , 它 是 一 个 从 数据 源 读 取 数据 的 抽象 类 , 它 定 义 了 读 
取 数 据 的 基本 方法 read 和 关闭 文件 的 方法 close. 继 承 它 的 子 类 要 重新 定义 其 所 定义 
的 抽象 方法 。InputStream 及 其 派生 类 如 图 7-4 所 示 。OutputStream 是 所 有 表示 位 
输出 流 的 类 的 父 类 , 它 是 一 个 将 数据 写 入 数据 宿 的 抽象 类 , 它 定义 有 写 文 件 write 和 
关闭 文件 close 等 基本 方法 , 子 类 要 重新 定义 其 中 所 定义 的 抽象 方法 。OnputStream 
及 其 派生 类 如 图 7-5 所 示 。Reader 及 其 派生 类 如 图 7-6 所 示 , Writer 及 其 派生 类 如 
7-7 所 示 。 
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7.3.2 文件 编程 过 程 


Java 文件 操作 过 程 : 四 创建 或 获取 一 个 和 文件 相关 联 的 对 象 ; @ 调 用 对 象 的 成 员 函 
数 实现 文件 数据 内 容 的 读 写 ; @ 关 闭 文件 关联 和 销毁 对 象 。 

虽然 基 类 InputStream/ OutputStream 提供 文件 内 容 操 作 的 基本 功能 接口 ,包括 函数 
read、write ,close 和 skip 等 .但 由 于 InputStream/ OutputStream 是 抽象 类 ,因此 都 要 创 
建 出 其 派生 类 对 象 来 实现 文件 读 写 。FileInputStream/FileOutputStream 用 于 本 地 文件 
读 写 (二 进 制 读 写 且 是 顺序 读 写 . 读 和 写 要 分 别 创建 出 不 同 的 文件 流 对 象 ) ,本 地 文件 ( 数 
据 源 或 数据 宿 ) 读 写 编程 的 基本 过 程 为 : 生成 文件 流 对 象 ( 对 文件 读 操作 时 应 该 为 
FileInputStream 类 对 象 . 而 文件 写 应 该 为 FileOutputStream 类 对 象 ); 四 调用 
FileInputStream 或 FileOutputStream 类 中 的 功能 函数 (read 和 write 等 ) 读 写 文件 内 容 ; 
回调 用 close 方法 关闭 文件 。 为 了 文件 读 写 性 能 ,一 般 会 加 入 缓冲 功能 .可 由 类 
BufferedInputStream/ BufferedOutputStream 实现 ;为 了 能 以 一 种 同 设 备 无 关 ( 当 前 操作 
系统 等 ) 的 方式 直接 按 字 节 读 写 Java 基本 类 型 和 String 类 型 的 数据 .可 由 类 
DataInputStream/DataOutputStream 来 直接 读 写 数据 。 7-8 是 Java 本 地 文件 读 写 过 
程 ,上 半 部 是 读 过 程 , 先 从 数据 源 读数 据 . 再 通过 缓冲 提高 读 性 能 .最 后 是 程序 读 取 基 本 类 
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型 和 String 类 型 数据 :下 半 部 是 写 过 程 .先是 程序 写 基本 类 型 和 String 类 型 数据 ,再 通过 
缓冲 提高 文件 写 性 能 ,最 后 把 数据 写 到 数据 宿 。 
增加 了 读 取 Java 基 本 
从 文件 中 获取 输入 字 节 ”增加 了 缓冲 功能 数据 类 型 的 功能 
(《 数据 源 FileInputStream 上 -一 BufferedinputStream 六 一 DatalnputStream 一 一 人 短 序 
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可 以 往 输入 流 中 写 入 提供 数据 写 入 到 将 数据 写 入 到 文件 中 
Java 基 本 数据 类 型 缓冲 区 功能 


图 7-8 Java 本 地 文件 读 写 过 程 


7.3.3 文件 持久 化 编程 


例 7-5 是 JavaScript 本 地 文件 编程 范例 , 例 中 包含 readFileByByte、readFileByBytes、 
readFileByLines 和 append 函数 。readFileByByte 用 于 读 二 进 制 文件 ,以 字 节 为 单位 ,每 
次 读 一 个 字 节 。readFileByBytes 用 于 读 二 进 制 文件 ,以 字 节 为 单位 ,每 次 读 100 个 字 节 。 
readFileByLines 适用 于 由 行 组 成 的 文本 文件 的 读 取 , 每 次 读 一 行 数 据 。Append 用 于 向 
文件 尾 追加 新 内 容 。 

【 例 7-5】 〈 代 码 位 置 : \7\fileOperDemo. js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); // 创 建 Android 对 象 
/活活 关 六 并 关 关 闫 其 其 关 关 半 类 关 闫 关 关 并 关 关 关 六 关 关 关 关 尖 关 闫 关 关 闫 尖 尖 闫 关 关 汪 尖 关 关 关 关 尖 关 关 关 半 关 关 关 关 关 关 关 关 闫 闫 闫 关 基 关 类 关 关 关 关 类 关 关 
* readFileByByte 功能 : 一 次 一 字 节 读 取 二 进 制 文件 ,包括 图 片 、 声 音 和 影像 等 文件 。 
其 拓 关 关 关 关 拓 扩 外 关 基 关 和 尖 外 扩 拓 和 类 关 和 并 站 儿 放 座 守 氏 挫 儿 庆 庆 让 站 闪 和 计 半 站 计 凑 纪 庆 关闭 其 关 关 半 闪 计 其 关 半 半 计 其 名 关 闪 计 拱 拓 六 其 放 
function readFileByByte (fileName) { 

var file=new java. io.File(fileName) ; 

// 一 次 读 一 个 字 节 

var fin=new java. io.FileInputStream (file); 

var tempbyte=""; 

while((tempbyte=fin. read()) !=-D){ 

java. lang. System. out. write (tempbyte) ; 

} 

fin. close( ; 
1 
/ 尖 尖 关 关 关 关 关 关 关 关 关 关 关 尖 关 关 尖 尖 尖 尖 尖 尖 尖 尖 关 关 关 关 尖 尖 关 尖 尖 尖 关 关 关 关 关 关 尖 关 关 闪光 光 关 关头 关 关 尖 
x* readFileByBytes 功能 : 读 二 进 制 文件 ,一 次 读 多 个 字 节 。 
关 关 闫 闫 关 尖 关 闫 尖 尖 尖 关 关 关 关 关 尖 尖 尖 尖 尖 尖 关 关 关 关 关 关 尖 尖 关 尖 尖 尖 关 关 关 关 关 关 尖 关 关头 尖 尖 关 关 关 关 关 关 关 / 
function readFileByBytes (fileName) { 

var tempbytes= java. lang. reflect. Array. newInstance (java. lang. Byte. TYPE, 100); 

var byteread=0; 
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var fin=new java. io.FileInputStream (fileName); 
// 读 入 多 个 字 节 到 字 节 数组 中 , byteread 为 一 次 读 入 的 字 节 数 
while ((byteread= fin.read(tempbytes)) !=-1){ 

java. lang. System. out. write (tempbytes, 0, byteread):; 
! 
fin.close(); 


} 


/ 计 尖 关 闫 尖 尖 关 关 并 六 湛江 闫 闫 尖 湛江 尖 关 针尖 并 关 尖 闫 美美 关 闪光 关 关 关 闫 关 关 关 关 关 关 关 关 关 关 
x* readFileByLines 功能 : 以 行为 单位 读 取 文件 
关 闫 汰 尖 闪闪 关 关 尖 关 闪闪 尖 关 关 关 关 关 关 尖 尖 关 关 关 关 尖 关 关 关 关 关 关 关 闪 关 关 关 关 关 关 关 关 关 关 关 关 关 / 
function readFileByLines (fileName) { 
var file=new java. io.File (fileName):; 
java. lang. System. out. println(“ 以 行为 单位 读 取 文件 内 容 , 一 次 读 一 整 行 :“); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var line=1; 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
// 显示 行 号 
java. lang. System. out. println(“1ine “+line+”: “+tempString); 
line++ ; 
} 
reader. close (); 


} 


/ 尖 尖 尖 关 关 汪汪 关 尖 关 关 尖 尖 关 关 汪汪 关 关 美 关 关 尖 尖 闫 美 半 尖 尖 尖 美美 尖 尖 关 关 关 关 尖 美美 尖 尖 关 


* append 功能 : 追加 内 容 到 文件 尾 


闫 关 关 关 关 闫 关 关 关 关 交 关 关 关 关 关 关 关 关 关 关 关 尖 关 关 关 关 关 尖 关 关 关 关 关 尖 关 尖 关 关 关 关 关 尖 关 关 关 关 关 关 关 关 / 

function append( fileName, content) { 
// 打 开 一 个 写 文件 器 ,构造 函数 中 的 第 二 个 参数 true 表示 以 追加 形式 写 文件 
var writer=new java. io.FileWriter (fileName, true); 
writer. write (content); 


writer. close() ; 


readFileByBytes(”/sdcard/sl4a/scripts/test. txt”); // 测 试 


7.4 网 络 持久 化 


7.4.1 JavaScript 与 Java 网 络 类 


网 络 编程 的 主要 作用 是 直接 或 间接 地 通过 网 络 协议 与 其 他 计算 机 进行 通信 。 网 络 编 
程 有 两 个 主要 问题 要 解决 .一 个 是 如 何 准确 定位 网 络 上 一 台 或 多 台 主 机 , 另 一 个 就 是 定位 
到 主机 后 如 何 可 靠 高 效 地 进行 数据 传输 。TCP 和 UDP 网 络 协议 可 以 解决 这 两 个 问题 。 
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TCP 是 Tranfer Control Protocol 的 简称 .是 一 种 面向 连接 的 保证 可 靠 传 输 的 协议 。 通 过 
TCP 传输 ,得 到 的 是 一 个 顺序 且 无 差错 的 数据 流 。UDP 是 User Datagram Protocol 的 简 
称 ,是 一 种 无 连接 的 协议 ,要 传输 的 数据 被 分 割 和 封装 成 数据 包 . 每 个 数据 包 都 包括 完整 
的 源 地 址 或 目的 地 址 , 它 在 网 络 上 以 任何 可 能 的 路 径 传 往 目的 地 ,但 能 否 到 达 目 的 地 ,到 
达 目 的 地 的 时 间 以 及 内 容 的 正确 性 都 是 不 能 被 保证 的 。 总 之 .TCP 在 网 络 通信 上 有 极 强 
的 生命 力 , 它 被 广泛 应 用 在 要 求 可 靠 传 输 数据 的 应 用 中 ,例如 ,远程 连接 (Telnet) 和 文件 
传输 LFTP) 等 应 用 。 相 比 之 下 UDP 操作 简单 .而 且 仅 需要 较 少 的 监护 .通常 用 在 用 户 对 
数据 实时 性 的 要 求 很 高 而 对 数据 完全 正确 性 的 要 求 又 有 所 降低 的 应 用 系统 中 ,比如 ,聊天 
系统 个 别 数据 包 丢 失 或 者 有 误 , 用 户 可 能 就 得 到 一 些 不 清楚 的 声音 ,但 不 会 影响 聊天 正常 
进行 。 由 于 TCP 相对 UDP 应 用 面 更 广泛 ,因此 本 节 主 要 介绍 基于 TCP 的 通信 。 

由 于 JavaScript 的 网 络 编程 能 力 偏 弱 . 因此 JavaScript 需要 借助 Rhino 引擎 使 用 
Java 网 络 开发 类 库 才 可 强化 其 网 络 开 发 功能 。 为 简化 网 络 编程 ,Java 通过 URL 和 套 接 
字 透 明 化 了 TCP 和 UDP。URL(Uniform Resource Locator) 中 文 名 为 统一 资源 定位 符 ， 
有 时 也 被 俗称 为 网 页 地 址 ,其 表示 为 互联 网 资源 ,如 网 页 或 者 FTP 地 址 。 通 过 URL 可 以 
访问 Internet 上 的 各 种 网 络 资源 ,比如 最 常见 的 WWW 和 FTP 站 点 。URL 有 固定 的 格 
式 : protocol://resourceName。 协 议 名 (protocol) 指 明 获 取 资 源 所 使 用 的 传输 协议 ,如 
http ftp .gopher 和 file 等 ,资源 名 (resourceName) 则 指 资源 的 完整 地 址 ,包括 主机 名 、 端 
口号 .文件 名 或 文件 内 部 的 一 个 引用 。 下 面 是 关于 URL 的 三 个 实例 ,第 一 个 例子 指明 了 
传输 协议 和 主机 地 址 ,第 二 个 例子 指明 传输 协议 .主机 地 址 和 主机 文件 ,第 三 个 例子 指定 
传输 协议 .主机 地 址 .主机 端口 号 和 主机 文件 。Java 的 URL 类 包含 在 java. net 包 中 , 通 
过 URL 类 中 的 方法 可 以 不 需要 了 解 具体 的 传输 协议 就 实现 数据 传输 。 


http://www. sun. com/ 
http://home. netscape. com/home/welcome. html 


http://www. gamelan. com:80/Gamelan/network. html 


对 于 即时 类 应 用 或 者 即时 类 的 游戏 .HTTP 和 FTP 等 标准 协议 很 多 时 候 无 法 满足 
于 此 类 应 用 的 通信 需求 .这 时 套 接 字 就 可 以 发 挥 作用 了 。 套 接 字 也 称 Socket, 对 于 一 个 
给 定 的 连接 ,每 台 机 器 上 都 有 一 个 套 接 字 . 套 接 字 之 间 有 一 条 虚拟 的 “电线 ”. 套 接 字 通过 
“电缆 ”传输 数据 。 也 可 以 这 样 理解 .网 络 上 的 服务 器 和 客户 端 两 个 程序 通过 一 个 双向 的 
通信 连接 实现 数据 的 交换 .这 个 双向 链 路 的 一 端 称 为 一 个 套 接 字 。 服 务 器 程序 负责 等 待 
和 监听 客户 的 连接 请 求 。 客 户 程序 主动 呼叫 服务 器 :呼叫 成 功 后 会 使 用 客户 端 套 接 字 和 
服务 器 端 套 接 字 进 行 通信 。Java 使 用 类 ServerSocket 和 类 Socket 实现 服务 器 端 和 客户 
端的 通信 。Socket 和 ServerSocket 类 库 位 于 java. net 包 中 。 类 ServerSocket 用 于 服务 
器 端 ,ServerSocket 会 绑 定 服务 器 端 IP 和 一 个 特定 端口 号 ,负责 监听 和 响应 客户 端的 请 
求 连接 。 在 连接 成 功 时 .服务 器 和 客户 端 应 用 程序 都 会 分 别 产生 一 个 Socket 实例 ,操作 
Socket 可 以 完成 数据 交换 。 对 于 一 个 网 络 连接 来 说 .Socket 是 平等 的 .并 没有 差别 .不 会 
因为 在 服务 器 端 或 在 客户 端 而 产生 不 同 。 
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7.4.2 网 络 编程 过 程 


在 网 络 中 ,服务 器 处 于 被 动 等 待 连接 的 地 位 .客户 端 处 于 主动 向 服务 器 发 动 连接 的 地 
位 ,网 络 编程 模型 通常 由 以 下 4 个 步骤 实现 。 


1. 监听 连接 


由 于 服务 器 用 来 被 动 等 待 客户 连接 ,所 以 服务 器 需要 先 启动 和 监听 本 地 IP 的 某 个 固 
定 端口 ,这 个 端口 就 是 服务 器 端 开 放 给 客户 端的 端口 。 把 服务 器 本 地 IP 和 某 个 端口 号 绑 
定 到 ServerSocket 实例 后 .监听 工作 就 交 给 该 实例 负责 。 


2. 获得 连接 


当 客 户 端 通过 Socket 实例 向 服务 器 发 起 连接 ,服务 器 端 接受 连接 后 就 可 以 获得 一 个 
Socket 实例 ,此 时 这 两 个 Socket 实例 就 建立 起 了 一 个 “连接 ”, 服 务 器 端 套 接 字 和 客户 端 
套 接 字 通过 这 个 “连接 ”来 交换 数据 .一般 在 服务 器 端 编程 中 , 当 获 得 连接 时 ,需要 开启 专 
门 的 线程 处 理 该 连接 .每 个 连接 都 由 独立 的 线程 实现 。 


3. 交换 数据 


服务 器 端 和 客户 端 交换 数据 次 序 通常 是 先 由 服务 器 端 接收 客户 端 发 送 过 来 的 数据 ， 
然后 服务 器 端 对 数据 进行 加 工 处 理 , 最 后 服务 器 端 再 把 处 理 过 的 数据 发 送 给 客户 端 。 

4. 关闭 连接 

当 交 换 完 数据 后 .需要 关闭 这 个 连接 ,关闭 工作 可 以 由 客户 端 也 可 以 由 服务 器 端 来 
做 。 关 闭 连接 时 ,应 该 要 释放 服务 器 端 和 客户 端 占用 的 资源 。 

为 便于 理解 ,可 以 把 网 络 编程 模型 比拟 为 呼叫 中 心 的 实现 ,例如 ,移动 客服 电话 
10086 这 个 电话 号 码 就 类 似 于 服务 器 端的 端口 号 码 ,每 个 拨打 10086 的 用 户 就 相当 于 一 
个 客户 端 程序 .每 个 客服 人 员 就 相当 于 服务 器 端 启动 的 专门 和 客户 端 连接 的 线程 ,每 个 线 
程 都 是 独立 进行 交互 的 。 

7.4.3 网 络 持久 化 编程 


下 面 是 URL 范例 . 例 中 使 用 URL 访问 百度 首页 .通用 协议 为 http ,主机 为 www. 
baidu. com ,端口 号 为 80, 页 面 为 index. htm。 
【 例 7-6】 (代码 位 置 : \7\network) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); // 创 建 Android 对 象 
function testURL() 


var url=new java. net.URL(“http“,“www.baidu. com”, 80, ”index. htm”); 
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例 7-7 是 Chat 聊天 系统 ,系统 由 服务 端 和 客户 端 组 成 ,两 者 使 用 套 接 字 通信 ,服务 端 
负责 监听 客户 端 连接 ,客户 端 主动 发 起 会 话 , 客 户 端 会 先 发 送 消息 “你 好 "给 服务 器 ,服务 
器 接收 后 会 回复 消息 “HELLO” 给 客户 端 ,客户 端 接收 后 会 再 次 发 送 消息 “再 见 ” 给 服务 
器 ,服务 器 接收 后 会 再 次 回复 “GoodBye” 给 客户 端 。 

【 例 7-7】 (代码 位 置 : \7\Chat) 

服务 器 端 文 件 Server. js: 


Androidd 脚本 应 用 开发 技术 


客户 端 文件 Client. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
// 包 含 开发 Android 应 用 必需 的 文件 Android. php 
var droid= new Android(); // 创 建 Android 对 象 
function run() 
{ 
var socket=new java. net. Socket (“127. 0. 0. 1”, 9991); 


var netOut= socket. getOutputStream(); 

var doc=new java. io. Data0utputStream (netOut) ; 

var nin= new java. io.DataInputStream(socket. getInputStream()) ; 
// 第 一 次 向 服务 器 端 发 送 字符 串 

java. lang. System. out. println(“ 客 户 端 :“+“ 你 好 ) ; 

doc. writeUTF (“你 好 ”) ; 

var res=nin. readUTF () ; // 接 收服 务 器 回复 

java. lang. System. out.println(“ 服 务 器 端 :“+res) ; 


// 第 二 次 向 服务 器 端 发 送 字符 串 

java. lang. System. out. println(“ 客 户 端 “+ 再见); 

doc. writeUTF (再见); 

res=nin. readUTF () ; // 再 次 接收 服务 器 回复 
java. lang. System. out. println(“ 服 务 器 端 :“+res) ; 

doc. close(); 


nin. close(); 


if (socket !=null) 


socket. close(); 
} 


run () ; 


先 启动 SL4A 运行 服务 器 端 程序 ,然后 返回 到 桌面 ( 按 手机 HOME 键 ) 再 次 启动 
SL4A 运行 客户 端 程序 .最 后 观察 运行 结果 。 图 7-9 是 Chat 系统 的 运行 结果 .其 中 .图 7-9 
(a) 是 客户 端 结果 .图 7-9(b) 是 服务 器 端 结 果 。 需 要 注意 .服务 器 和 客户 端 要 以 控制 台 方 
式 运行 .否则 无 法 观察 到 运行 结果 


中国 移动 $( 


7.0.0.1:35559] tm 
tcp port:9: 

客户 端 : 你 好 

最 务 注 : HELLO 

膏 户 端 : 再 见 

最 务 端 : Go 





(a) 客户 蹦 (b) 服 





图 7-9 Chat 系统 
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Android 的 4 个 基本 组 件 


8.1 意 图 


8.1.1 意图 是 什么 


在 Windows 系统 中 ,后 台 服 务 和 静 动 态 库 等 是 组 成 应 用 程序 的 主要 组 件 。 和 
Windows 系统 类 似 , 在 Android 系统 中 ,一 个 Android 应 用 主要 由 活动 .广播 .服务 和 
内 容 提供 者 4 种 组 件 组 成 ,Android 应 用 的 功能 由 这 4 种 组 件 共同 来 完成 。 这 4 种 组 
件 彼 此 之 间 是 互相 独立 的 ,这 种 独立 性 体现 在 它们 在 命名 空间 和 内 存 运 行 空 间 等 方 
面 是 可 以 互 不 相干 的 。 尽 管 组 件 彼 此 间 独 立 . 但 4 大 组 件 会 在 应 用 程序 运行 过 程 中 
互相 交换 数据 和 协调 工作 ,它们 之 间 的 互相 调用 和 协调 工作 最 终 完 成 Android 应 用 
的 功能 。 

彼此 独立 的 4 大 组 件 是 如 何 交 换 数 据 的 呢 ? 这 依赖 于 Android 系统 提供 的 意图 通信 
机 制 .“ 意 图 "其 英文 翻译 为 Intent, Android 系统 提供 了 Intent 机 制 用 来 协助 应 用 程序 
之 间 的 交互 与 通信 ,或 者 更 准确 地 说 .Intent 通信 机 制 不仅 可 用 于 应 用 程序 之 间 的 通信 ， 
也 可 用 于 构成 应 用 程序 的 4 大 组 件 之 间 的 相互 通信 。Intent 是 一 种 运行 时 绑 定 机 制 , 它 
可 以 在 程序 运行 状态 中 传递 数据 ,或 者 说 ,意图 中 的 数据 可 以 不 国 化 在 程序 代码 中 ,可 以 
通过 程序 代码 动态 生成 数据 并 传递 给 相关 的 组 件 处 理 。Intent 在 组 件 中 起 着 一 个 媒体 中 
介 的 作用 ,专门 提供 组 件 互相 调用 的 相关 信息 ,实现 了 调用 组 件 与 被 调用 组 件 之 间 的 解 
耦 。Intent 是 一 种 对 象 数据 .一 个 Intent 对 象 由 动作 等 多 个 预先 定义 好 的 数组 项 组 成 ,这 
些 数组 项 可 以 是 复合 型 和 简单 型 数据 。 和 传统 的 数据 通信 方法 不 同 的 是 , Intent 通信 机 
制 不 仅 可 以 在 组 件 之 间 传 递 数 据 ,而 且 可 以 唤醒 组 件 , 即 使 这 个 被 唤醒 的 组 件 从 来 就 没有 
被 Android 系统 运行 过 ,意图 还 是 可 以 唤醒 这 个 组 件 使 其 可 以 占用 CPU 资源 并 处 理 意图 
传递 过 来 的 数据 。 

当 一 个 意图 出 现 的 时 候 . 并 不 是 所 有 的 组 件 都 会 去 响应 这 个 意图 .只 有 那些 注册 了 响 
应 此 意图 的 组 件 才 会 去 响应 这 个 意图 。 有 一 个 活动 组 件 希 望 打开 网 页 浏览 器 查看 某 一 网 
页 的 内 容 . 这 个 活动 组 件 只 需要 发 出 ”WEB_SEARCH_ACTION"” 意 图 给 Android 系统 ， 
Android 系统 就 会 根据 这 个 意图 的 请 求 内 容 . 查 询 已 注册 响应 这 个 意图 的 网 页 浏览 器 组 
件 , 查 到 这 样 的 组 件 后 会 启动 运行 这 个 组 件 。 当 有 多 个 注册 组 件 时 . 需 由 用 户 手工 指定 一 
个 组 件 响 应 意图 。 
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意图 通信 工作 机 制 : 先 由 调用 组 件 创建 意图 对 象 和 提交 意图 对 象 给 Android 系统 ， 
再 由 Android 系统 根据 意图 对 象 的 数据 启动 相干 的 被 调用 组 件 . 最 后 被 调用 组 件 接收 意 
图 对 象 和 处 理 意图 对 象 传递 过 来 的 数据 。 假设 一 个 “联系 人 "应 用 由 组 件 A 和 组 件 B 构 
成 .组件 A 的 作用 是 显示 联系 人 列表 .组 件 B 的 作用 是 显示 联系 人 的 详细 信息 , 现 要 求实 
现 这 样 的 需求 : 在 联系 人 列表 中 单 击 某 个 联系 人 后 .能 够 显示 出 此 联系 人 的 详细 信息 。 
要 用 Intent 机 制 实现 这 样 的 需求 .组件 A 需要 构造 一 个 Intent 对 象 .让 这 个 Intent 对 象 
承载 “查看 联系 人 "动作 数据 和 “ 某 联系 人 ”相关 数据 .组件 A 把 这 个 Intent 传递 给 
Android 系统 处 理 . 这 意味 着 组 件 A 把 “自己 想 查 看 某 联 系 人 的 详细 信息 ”这 个 意图 告诉 
了 Android 系统 .Android 系统 会 解析 这 个 Intent 对 象 所 承载 的 数据 ,Android 系统 开明 
白 了 这 个 意图 后 ,会 先 根据 “查看 联系 人 "动作 数据 启动 对 应 的 组 件 B, 再 把 “ 某 联系 人 " 相 
关 数 据 传递 给 组 件 B, 最 后 组 件 B 会 从 数据 库 系统 中 检索 “ 某 联系 人 ”的 详细 数据 并 显示 
出 来 。 在 这 个 案例 中 .组 件 A 构造 了 “查询 某 联 系 人 ”的 意图 和 发 送 了 意图 请 求 ,Android 
系统 根据 意图 内 容 启 动 了 组 件 B, 组件 B 负责 处 理 意 图 数据 ,对 于 开发 者 而 言 ,Android 
系统 解析 意图 和 启动 组 件 的 行为 是 透明 的 .其 关心 的 是 如 何在 组 件 A 中 构造 意图 和 在 组 
件 中 如 何 截取 和 处 理 意图 数据 。 


8.1.2 意图 数据 结构 


一 个 Intent 对 象 由 action data ,category type、 packagename,、classname、extras 和 
flag 等 属性 组 成 。action 是 意图 动作 ,data 是 动作 数据 .category 是 动作 类 别 ,type 是 数 
据 类 型 .packagename 是 包 名 ,classname 是 类 名 ,extras 是 扩展 信息 ,flag 是 标志 位 。 下 
面 是 这 些 属性 的 具体 描述 。 

action 属性 的 作用 是 用 来 指明 意图 的 抽象 行为 .或 者 说 ,描述 了 意图 想 要 实施 什么 动 
作 。 之 所 以 说 行为 是 抽象 的 .是 因为 这 种 行为 并 不 是 由 意图 来 实现 的 .而 是 由 具体 的 组 件 
来 完成 的 , 它 可 以 由 不 同 的 具体 组 件 来 完成 。 在 日 常生 活 中 .可 以 用 “我 要 听 歌 ,我 要 写 
信和 ,我 要 去 学 校 ” 等 类 似 的 描述 指明 个 人 的 意图 .这 里 的 “听写 "和 “去 "就 是 意图 的 动作 。 
在 Intent 中 ,action 的 作用 就 是 用 来 描述 个 人 意图 中 类 似 “ 昕 ” 写 ”" 和 “去 ”等 这 样 的 动作 。 
当 意 图 对 象 指 明了 一 个 action 值 .Android 系统 这 个 执行 者 就 会 依照 这 个 动作 值 的 指示 
去 调用 和 这 个 动作 相干 的 组 件 来 接受 相关 输入 和 产生 相应 的 输出 。 为 便于 理解 ,可 以 把 
action 理解 为 编程 语言 中 的 方法 名 或 者 是 模块 入 口 。 一 个 意图 最 多 只 能 有 一 个 动作 。 在 
很 大 程度 上 ,action 决定 了 意图 到 底 要 做 什么 , 正 因 它 如 此 重要 .每 个 意图 对 象 都 应 该 明 
确 指定 动作 属性 值 和 动作 相关 的 其 他 意图 对 象 属性 值 。action 属性 值 可 以 用 字符 串 来 表 
示 . 它 可 划分 为 用 户 自 定义 的 action 值 和 Android 系统 预定 义 的 action 值 。 自 定义 动作 
字符 串 应 该 包含 应 用 程序 包 名 前 缀 .如 “com. example. myproject. SHOW _PIC”。 
Android 系统 定义 了 一 大 批 动 作 值 .其 基本 涵盖 了 常用 动作 . 表 8-1 列 出 了 一 些 常用 的 系 
统 活动 动作 。 
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表 8-1 系统 活动 动作 

































































动作 字符 串 动作 含义 

android. intent. action. MAIN 应 用 程序 入 口 ,而 并 不 期 望 去 接收 数据 
android. intent. action. VIEW 显示 指定 数据 (短信 、 网 页 .地 图 、 应 用 详 表 、 音 乐 和 视频 等 ) 
android. intent. action. ATTACH_DATA ee it hada ab 
android. intent. action. EDIT 编辑 指定 数据 
android. intent. action. PICK 从 列表 中 选择 某 项 并 返回 所 选 的 数据 
android. intent. action. CHOOSER 显示 一 个 Activity 选择 器 
android. intent. action. GET_CONTENT > I 人 bd pip 各 史 风 荣昌 ,二 克 向 
android. intent. action. DIAL 显示 拨号 面板 
android. intent. action. CALL 直接 向 指定 用 户 打 电 话 
android. intent. action. SEND 向 其 他 人 发 送 彩信 等 
android. intent. action. SENDTO 向 其 他 人 发 送 邮件 和 短信 等 消息 
android. intent. action. ANSWER 应 答 电话 
android. intent. action. INSERT 插入 一 条 空 项 目 到 已 给 的 容器 
android. intent. action. DELETE 删除 数据 
android. intent. action. RUN 运行 数据 (指定 的 应 用 ) ,无论 它 (应 用 ) 是 什么 
android. intent. action. SYNC 执行 数据 同步 
android. intent. action. PICK_ACTIVITY | 用 于 选择 activity, 返 回 被 选择 的 activity 的 类 名 
android. intent. action. SEARCH 执行 搜索 
android. intent. action. WEB_SEARCH 执行 Web 搜索 
android. intent. action. FACTORY_TEST | 工厂 测试 的 入 口 点 

data 是 动作 要 操作 的 数据 。 日 常生 活 中 用 “我 要 看 小 品 节目 .我 要 去 学 校 * 这 样 的 语 


言 来 表达 个 人 意图 .“ 看 "和 “去 "就 是 意图 中 的 动作 .而 “小 品 节目 ”和 “学 校 * 就 是 动作 要 处 
理 的 数据 。Data 表示 的 就 是 类 似 * 小 品 节目 ”这样 需要 处 理 的 数据 。data 可 以 用 URI 格 
式 来 描述 .不同 的 动作 其 对 应 的 URI 格式 会 不 同 , 但 URI 可 以 用 统一 的 URI 字符 串 格 式 
表示 ,其 格式 为 “scheme://host:port/path”。 这 个 URI 既 包 含 数 据 也 包含 数据 的 数据 类 
型 ,通过 URI 就 可 以 解析 出 数据 和 数据 类 型 。 例 如 . 打 电 话 动作 的 URI 可 以 表示 为 “tel: 
10086”, 要 处 理 的 数据 是 10086,10086 这 个 数据 的 数据 类 型 是 tel。 常见 的 URI 字符 串 
见 9.1 节 内 容 。 

category 属性 描述 了 响应 意图 的 目标 组 件 所属 的 类 别 。 它 的 值 用 字符 串 表 示 。 一 个 
意图 对 象 可 以 有 任意 个 category。 表 8-2 是 系统 定义 的 常见 category 字符 串 。 
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表 8-2 category 字符 串 






































category 字符 串 含 流 
android. intent. category. DEFAULT 默认 的 category 
android. intent. category. BROWSABLE 指定 该 Activity 能 被 浏览 器 安全 调用 
android. intent. category. TAB 指定 Activity 作为 TabActivity 的 Tab 页 
android. intent. category. LAUNCHER Activity 显示 在 顶级 程序 列表 中 
android. intent. category. INFO 用 于 提供 包 信息 
android. intent. category. HOME 设置 该 Activity 随 系统 启动 而 运行 
android. intent. category. PREFERENCE 该 Activity 是 参数 面板 
android. intent. category. TEST 该 Activity 是 一 个 测试 
android. intent. category. CAR_DOCK 指定 手机 被 插入 汽车 底座 (硬件 ) 时 运行 该 Activity 
android. intent. category. DESK_DOCK 指定 手机 被 插入 桌面 底座 (硬件 ) 时 运行 该 Activity 
android. intent. category. CAR_MODE 设置 该 Activity 可 在 车 载 环 境 下 使 用 


type 属性 的 主要 作用 是 对 Intent 的 数据 类 型 做 显 式 强制 性 说 明 ,通过 设置 这 个 属 
性 ,可 以 强制 显 式 指定 数据 类 型 而 不 再 进行 推导 。 假 设 属性 data 描述 的 是 文件 路 径 ， 
为 文件 可 以 是 图 像 .音频 和 视频 等 格式 .如果 不 指明 文件 格式 ,那么 就 无 法 得 知 应 该 使 用 
哪 类 应 用 程序 打开 文件 :如果 指定 了 type 属性 值 . 则 可 以 根据 这 个 type 属性 值 强制 选择 
对 应 的 应 用 程序 打开 文件 ,type 属性 值 应 该 要 和 文件 实际 内 容 保持 一 致 ,否则 打开 文件 
会 出 现 错误 。 一 般 情况 下 .系统 会 根据 协议 分 析出 data 属性 值 的 数据 类 型 .如果 data 无 
法 设置 数据 类 型 或 者 协议 无 法 分 析出 data 的 数据 类 型 , 则 应 用 设置 type 数据 类 型 值 。 

type 属性 用 MIME 对 意图 的 数据 类 型 进行 强制 声明 。MIME 英文 全 称 为 
Multipurpose Internet Mail Extensions ,中文 翻译 为 多 用 途 互 联网 邮件 扩展 类 型 。 最 初 
的 HTTP 并 没有 区 分 数据 类 型 ,浏览 器 会 把 HTTP 传送 的 数据 都 解释 为 HTML 文档 。 
为 了 支持 多 媒体 数据 类 型 .HTTP 为 HTML 文档 附加 了 MIME 数据 项 ,浏览 器 会 根据 
MIME 数据 项 值 自动 使 用 指定 应 用 程序 来 打开 HTML 文档 。MIME 数据 项 由 两 部 分 组 
成 .前面 是 数据 的 大 类 别 . 后 面 是 具体 的 种 类 。 例 如 …image/jpeg" 中 的 image 表示 数据 
是 图 像 .jpeg 表示 数据 用 jpge 格式 表示 .image 是 大 类 别 .jpge 是 具体 种 类 。 

extras 属性 是 意图 中 的 其 他 附加 信息 集合 . 它 在 组 件 间 传递 信息 时 非常 有 用 。 它 通 
过 键 名 键 值 对 的 方式 把 数据 保存 在 属性 extras 里 .传递 的 数据 可 以 是 整数 、 浮 点 数 和 字 
符 串 等 基本 数据 类 型 :也 可 以 是 数组 和 对 象 等 复合 型 数据 类 型 。 一些 携 带 较 多 数据 项 的 
意图 或 特定 意图 会 使 用 extras 而 不 是 用 data 存储 数据 。 例 如 : 插 拔 耳 塞 广播 类 型 动作 会 
使 用 extras 携带 数据 ,其 携带 的 数据 项 “state" 用 来 表示 耳机 插 拔 行为 ,数据 项 “name” 表 
示 耳 机 类 型 .数据 项 “microphone” 表 示 耳 机 是 否 带 麦克 风 。 例 如 .要 执行 “发 送 电 子 邮 件 ” 
这 个 动作 ,可 以 将 电子 邮件 的 标题 和 正文 等 内 容 保存 到 extras 属性 里 将 它 传递 给 电子 邮 
件 发 送 组 件 。 对 于 自 定义 的 动作 :可 以 将 值 存储 在 extras 中 传递 数据 。 例 如 ,应 用 程序 
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自 定 义 了 一 个 SHOW_COLORS 动作 ,可 以 将 颜色 值 以 键 值 对 的 方式 存储 在 extras 属性 
中 传递 数据 。 

flag 值 用 整数 表示 . 它 决定 了 活动 的 运行 顺序 。Android 系统 的 一 个 特点 是 应 用 程 
序 A 中 的 活动 组 件 可 以 启动 应 用 程序 B 中 的 活动 组 件 。 尽管 人 A 和 B 是 互 不 关联 的 应 
用 ,但 在 用 户 看 来 ,这 两 个 活动 组 件 紧密 联系 ,视觉 上 二 者 构成 了 一 个 整体 。Android 系 
统 用 Task 来 管理 活动 组 件 . 从 表现 上 看 .Task 就 像 是 一 个 栈 容器 ,活动 组 件 就 是 栈 容器 
的 元 素 , 最 先 运 行 的 活动 组 件 处 于 栈 底 ,最 后 运行 的 活动 组 件 处 于 栈 顶 ,Task 最 先 从 栈 顶 
取 活 动 组 件 .也 就 是 说 最 先 取出 的 是 最 后 添加 的 活动 组 件 , 最 后 取出 的 是 最 先 运行 的 活动 
组 件 。 如 果 要 改变 Task 这 种 取出 活动 组 件 的 顺序 ,就 要 设置 属性 flag 的 值 。 通 过 设置 
flag 值 ,可 以 改变 活动 组 件 在 Task 容器 中 的 位 置 .例如 .或 者 可 以 让 活动 组 件 从 非 栈 顶 位 
置 移 至 栈 顶 位 置 ,或 者 可 以 清 掉 位 于 活动 组 件 之 上 的 所 有 活动 组 件 使 其 排 在 栈 顶 位 置 。 
关于 flag 值 的 定义 请 参看 其 他 参考 文献 资料 。 


8.1.3 构造 意图 及 通用 意图 


SL4A 提供 了 getIntent 和 makeIntent 分 别 用 来 截取 和 构造 意图 对 象 , 下 面 是 这 两 个 
方法 的 定义 形式 。 


getIntent () 


其 作用 是 获取 启动 脚本 应 用 的 意图 对 象 .方法 会 返回 一 个 意图 对 象 .意图 对 象 包括 


action ,data \type\packagename ,classname categories .extras 和 flags 属性 。 


makeIntent (String action, String uri (optional), String type (optional), JSONObject extras 
(optional), JSONArray categories (optional), String packagename (optional), String classname 
(optional), Integer flags (optional)) 


其 作用 是 构造 一 个 意图 对 象 , 除 action 外 ,其 他 参数 都 是 可 选 的 ,参数 extras 是 
JSON 对 象 数据 .参数 categories 是 数组 数据 .参数 flags 是 整数 数据 .其 他 参数 为 字符 串 
数据 。 

例 8-1 是 构造 意图 的 实例 . 例 中 构造 了 三 个 意图 对 象 .这 三 个 意图 分 别 用 来 打开 百度 
网 站 .播放 mp3 音乐 和 发 送 短 消息 。 

【 例 8-1】 (代码 位 置 : \8\testIntent. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var android=new Android(); 


//1. 浏览 网 页 ,演示 action 和 data 属性 的 使 用 
var action= “android. intent. action. VIEW”; 
var uri= “https://www. baidu. com/”; 

var intent=android. makeIntent (action, uri ); 


android. startActivityIntent (intent); 
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//2. 播放 mp3, 需 先 在 SD 卡 中 存储 文件 song. mp3, 演示 type 属性 的 使 用 
action= “android. intent. action. VIEW”; 

uri= ”file:///sdcard/song. mp3”; 

var type= “audio/mp3”; 

intent=android. makeIntent (action, uri, type ); 


android. startActivityIntent (intent); 


//3. 发 送 短信 ,演示 属性 extras 的 使 用 

action= “android. intent. action. SENDTO”; 

uri= “smsto:10086“; 

var type=null; 

var extras=" {“sms_body”: “The SMS text”}” ; 
extras=eval( (+extras + )); 

intent=android. makeIntent (action, uri, type, extras ) ; 
ret=android. startActivityIntent (intent); 


开发 人 员 可 根据 这 个 实例 举一反三 分 别 构造 发 送 彩 信 查看 地 图 .播放 视频 .打开 文 
档 ,查询 联系 人 和 打 电 话 等 通常 意图 


8.1.4 意图 的 启动 方式 


依据 是 否 直接 指明 目标 组 件 来 划分 意图 ,意图 可 分 为 显 式 和 隐 式 两 大 类 。 显 式 
Intent 直接 明确 了 目标 组 件 的 包 名 和 类 名 ,这 种 意图 将 运行 符合 包 名 和 类 名 的 组 件 。 但 
是 由 于 开发 人 员 往 往 并 不 清楚 其 他 应 用 程序 的 组 件 名 称 .因此 , 显 式 Intent 更 多 用 于 在 
应 用 程序 内 部 传递 消息 。 隐 式 Intent 并 没有 了 明确 目标 组 件 的 包 名 和 类 名 。 由 于 没有 了 明 
确 的 目标 组 件 名 称 , 所 以 隐 式 意图 必须 由 Android 系统 帮助 寻找 与 隐 式 意图 其 他 描述 信 
息 (action 和 data 等 属性 值 ) 最 匹配 的 组 件 。 不 会 用 组 件 名 称 定义 需要 激活 的 目标 组 件 ， 
它 更 广泛 地 用 于 在 不 同 应 用 程序 之 间 传 递 消 息 。 关 于 组 件 如 何 响应 隐 式 意图 问题 .由 于 
SL4A 并 没有 提供 这 方面 的 技术 支持 ,所 以 本 文 在 此 不 进行 阐述 ,读者 可 参阅 Android 
Java 相关 资料 

两 者 相 比 较 , 显 式 意图 的 优点 是 Android 系统 能 直接 准确 定位 目标 组 件 和 执行 效率 
高 ,但 缺点 是 组 件 间 的 耦合 度 较 高 。 通 过 显 式 组 件 调 用 目标 组 件 , 如 果 目 标 组 件 因为 版 本 
更 新 等 原因 更 改 了 组 件 的 类 名 和 包 名 , 那 就 会 导致 程序 不 能 正常 运行 甚至 崩溃 。 由 于 每 
次 执行 隐 式 意图 时 Android 系统 都 要 耗 时 搜索 目标 组 件 , 所 以 隐 式 意图 存在 执行 效率 偏 
低 等 缺点 ,但 能 够 降低 调用 组 件 和 被 调用 组 件 间 的 耦合 度 。 

之 前 的 意图 实例 并 没有 指明 包 名 和 类 名 .其 属于 隐 式 意图 应 用 范畴 。 下 面 是 显 式 意 
图 实例 . 例 中 指定 了 包 名 “com. android. music” 和 类 名 “com. android. music. 
MusicBrowserActivity”, 这 两 个 包 名 和 类 名 必须 是 Android 系统 已 经 安装 好 的 应 用 程序 
包 名 和 类 名 .运行 实例 前 请 先 确保 已 经 安装 了 此 应 用 .运行 实例 时 会 跳出 播放 音乐 的 应 用 
程序 。 


160 


弟 la 齐 ”Androig 的 4 人 基本 组 件 


【 例 8-2】 (代码 位 置 : \8\testExplicitIntent. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android=new Android(); 

var action=null; 

var uri=null; 

var type=null; 

Var extras=null ; 

var categories=null; 

var packagename= “com. android. music”; 

var classname= “com. android. music. MusicBrowserActivity”; 

var intent = android. makeIntent (action, uri, type, extras, categories, packagename, 
classname ); 

android. startActivityIntent (intent); 


8.2 活 动 


8.2.1 活动 是 什么 


Activity 中 文 翻 译 为 “活动 ” ,活动 是 Android 系统 4 大 组 件 之 一 , 它 也 是 最 常用 的 一 
种 组 件 。 一 个 应 用 程序 主要 是 由 一 个 或 多 个 活动 构成 的 .一 个 应 用 程序 拥有 多 少 个 活动 
取决 于 应 用 程序 的 设计 .第 一 个 被 启动 的 活动 为 主 活动 .其 他 非 主 活动 需要 通过 活动 跳 转 
才 被 运行 。 就 活动 关系 而 言 .应 用 程序 中 的 活动 是 彼此 独立 的 ,它们 主要 通过 意图 来 传递 
消息 。 从 Android 系统 管理 活动 角度 来 看 .活动 被 Task 容器 像 栈 一 样 进行 管理 . 先 运行 
的 活动 被 置 于 栈 底 .后 运行 的 活动 置 于 栈 顶 . 栈 顶 活动 先 出 栈 . 栈 底 活 动 后 出 栈 , 但 Task 
并 不 完全 按 栈 管理 活动 .这 种 进出 栈 顺序 是 可 以 改变 的 。 

从 用 户 角 度 看 .活动 就 是 屏幕 窗口 .窗口 是 可 视 的 .是 可 以 有 焦点 的 ,是 可 以 接受 用 户 
输入 的 。 例 如 ,一 个 活动 可 以 展示 菜单 列表 ,照片 .电话 联系 人 和 短信 等 信息 ,可 以 接受 用 
户 输 入 短信 、 单 击 菜单 项 和 新 建 联系 人 等 。 从 视觉 上 看 .活动 可 以 使 用 标准 化 的 布局 、 按 
钮 ,文本 框 、 菜 单项 和 复 选 框 等 控件 设计 和 呈现 窗口 界面 .也 可 以 使 用 2D 和 3D 的 绘图 方 
式 绘制 窗口 界面 ,前 者 主要 用 在 普通 的 Android 应 用 .后 者 用 于 Android 游戏 类 应 用 。 

从 生命 周期 来 看 .活动 可 以 划分 为 活动 状态 .暂停 状态 .停止 状态 和 待 用 状态 。 如 果 
活动 的 窗口 呈现 在 屏幕 前 台 ( 窗 口 可 视 ` 有 焦点 和 可 接受 用 户 输入 ) .那么 活动 为 活动 状 
态 ; 如 果 其 窗口 失去 焦点 .但 窗口 依然 可 见 (被 另 一 个 活动 组 件 的 非 全 屏 窗口 或 透明 窗口 
遮 住 ) . 则 活动 为 暂停 状态 .暂停 状态 的 活动 不 能 接受 用 户 的 输入 ,在 系统 内 存 极端 低 的 时 
候 可 能 会 被 杀 掉 ; 如 果 其 窗口 被 其 他 活动 的 窗口 完全 覆盖 . 则 窗口 被 覆盖 的 活动 为 停止 状 
态 .这 种 状态 活动 的 窗口 既 没有 焦点 也 不 能 接受 用 户 输入 .系统 需要 内 存 时 会 杀 掉 活动 组 
件 ; 如 果 活 动 被 从 内 存 中 删 掉 或 者 说 其 对 应 的 进程 被 杀 掉 . 则 活动 为 待 用 状态 .这 种 状态 
的 活动 不 但 没有 窗口 (当然 也 去 失去 焦点 和 不 能 接受 用 户 输入 ). 而 且 不 保存 活动 的 成 员 
信息 。 
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8.2.2 启动 活动 


SL4A 提供 4 种 方法 激活 活动 , 分别 是 startActivity、 startActivityForResult、 
startActivityForResultIntent 和 startActivityIntent 方法 .下面 是 方法 的 具体 定义 。 


startActivity (String action, String uri (optional), String type (optional), JSONObject extras 
(optional), Booleanwait (optional), String packagename (optional), String classname (optional)) 


其 作用 是 启动 新 活动 , 除 action 外 ,其 他 参数 都 是 可 选 的 ,参数 extras 是 JSON 对 象 
数据 ,其 他 参数 为 字符 串 数据 。 如 果 使 用 了 参数 packagename 和 classname, 则 要 求 这 两 
个 参数 必须 是 有 效 的 包 名 和 类 名 。 参 数 wait 表示 是 否 堵塞 当前 活动 直到 用 户 结束 新 活 
动 , 它 为 布尔 型 ,true 表示 堵塞 ,false 表示 不 堵塞 。 方 法 没有 返回 值 。 


startActivityForResult (String action, String uri (optional), String type (optional), 
JSONObject extras (optional), String packagename (optional), String classname (optional)) 


其 作用 是 启动 新 活动 . 除 action 外 .其 他 参数 都 是 可 选 的 ,参数 extras 是 JSON 对 象 
数据 ,其 他 参数 为 字符 串 数据 。 如 果 使 用 了 参数 packagename 和 classname, 则 要 求 这 两 
个 参数 必须 是 有 效 的 包 名 和 类 名 。 方 法 的 返回 值 是 Intent 键 值 对 。 活 动 调 有 这 个 方法 
后 会 被 堵塞 直到 新 启动 的 活动 被 用 户 结束 。 


startActivityForResultIntent (Intent intent) 


其 作用 是 用 意图 对 象 启动 新 活动 .参数 intent 的 数据 结构 是 Intent, 这 个 参数 值 可 以 
通过 方法 makeIntent 来 构造 ,方法 的 返回 值 是 Intent 键 值 对 。 


startActivityIntent (Intent intent, Boolean wait (optional)) 


其 作用 是 用 意图 对 象 启动 新 活动 ,参数 intent 的 数据 结构 是 Intent, 这 个 参数 值 可 以 
通过 方法 makeIntent 来 构造 ;参数 wait 表示 是 否 堵塞 当前 活动 直至 用 户 结束 新 活动 , 它 
为 布尔 型 ,true 表示 堵塞 .false 表示 不 堵塞 .方法 没有 返回 值 。 

例 8-3 是 方法 startActivityForResult 的 使 用 范例 .范例 程序 会 启动 文件 管理 器 或 图 
库 等 第 三 方 组 件 供 用 户 挑选 文件 .只 要 用 户 在 第 三 方 组 件 的 窗口 中 单 击 了 文件 ,第 三 方 组 
件 就 会 停止 运行 并 把 文件 的 路 径 ( 具 体 的 返回 内 容 由 第 三 方 组 件 决定 ) 返 回 给 范例 程序 . 
范例 程序 可 以 继续 对 这 个 返回 值 进行 加 工 处 理 。 

【 例 8-3】 〈 代 码 位 置 : \8\testActivityForResult. php) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js“) ; 
var android= new Android(); 
var action= “android. intent. action. PICK”; // 挑 选 文件 动作 
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var uri=null; 
var type=”* /x*”; // 文 件 类 型 
var ret=android. startActivityForResult ( action, uri, type ); 


// 以 Intent 格式 返回 数据 


8.2.3 活动 返回 值 设 置 


如 果 脚 本 应 用 程序 被 其 他 应 用 程序 调用 ,脚本 应 用 程序 是 否 可 以 把 脚本 的 运行 结果 返 
回 给 调用 程序 呢 ? 回答 是 肯定 的 。 脚 本 可 以 通过 SL4A 提供 的 setResultBoolean 等 方法 把 
运行 结果 返回 给 调用 程序 ,但 需要 注意 的 是 ,调用 程序 须 通过 方法 startActivityForResult 
(Java 程序 ) 调 用 脚本 程序 ,脚本 程序 才能 把 运行 结果 返回 给 调用 程序 。 设 置 返回 值 的 
setResultBoolean 等 方法 都 包括 两 个 参数 resultCode 和 resultValue, 参 数 resultCode 表 
示 脚 本 的 结束 状态 ,其 为 整数 类 型 .0 表示 脚本 被 取消 运行 ,一 1 表示 脚本 正常 结束 。 参 数 
resultValue 表示 返回 给 原 活动 的 值 ,可 以 是 布尔 型 .字符 串 、 整 数 、 浮 点 数 和 数组 等 类 型 。 
这 两 个 参数 会 以 意图 对 象 的 形式 封装 在 extras 属性 中 ,并 作为 返回 值 返回 给 调用 程序 。 
表 8-3 列 出 了 活动 返回 值 方法 。 


表 8-3 活动 返回 值 方法 
活动 返回 值 方法 


setResultBoolean( IntegerresultCode, BooleanresultValue) 








setResultBooleanArray(IntegerresultCode, BooleanresultValue) 





setResultByte(IntegerresultCode, Byte resultValue) 





setResultByteArray(IntegerresultCode, Byte resultValue) 





setResultChar(IntegerresultCode, Character resultValue) 





setResultCharArray(IntegerresultCode, Character resultValue) 





setResultDouble( IntegerresultCode, Double resultValue) 





setResultDoubleArray(IntegerresultCode, Double resultValue) 





setResultFloat( IntegerresultCode, Float resultValue) 





setResultFloatArray(IntegerresultCode, Float resultValue) 





setResultInteger(JntegerresultCode，IntegerresultValue) 





setResultIntegerArray(IntegerresultCode，IntegerresultValue) 





setResultLong( IntegerresultCode, Long resultValue) 





setResultLongArray( IntegerresultCode, Long resultValue) 





setResultSerializable(IntegerresultCode. Serializable resultValue) 





setResultShort(IntegerresultCode. Short resultValue) 





setResultShortArray(IntegerresultCode, Short resultValue) 





setResultString(IntegerresultCode. String resultValue) 





setResultStringArray(IntegerresultCode, String resultValue) 





setResultBoolean( IntegerresultCode, BooleanresultValue) 
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8.3.1 广播 是 什么 


Broadcast 也 称 广播 , 它 是 Android 系统 中 的 重要 组 件 , 也 是 一 种 广泛 运用 的 在 应 用 
程序 之 间 传 输 信 息 的 机 制 。 广播 到 底 有 什么 呢 ? 笼统 一 点 儿 讲 就 是 用 来 传输 数据 的 。 具 
体 地 讲 有 两 大 作用 。 一 个 作用 是 实现 不 同 程序 之 间 的 数据 传输 与 共享 ,因为 只 要 接收 者 
注册 接收 某 项 广播 ,接收 者 就 能 接收 这 项 广播 ,无论 这 项 广播 来 自任 何 播放 者 。 另 一 个 作 
用 是 通知 作用 .例如 , 插 拔 耳 机 、 按 音量 键 和 系统 来 电 等 行为 会 产生 广播 .广播 会 通知 音乐 
系统 等 应 用 调整 音量 大 小 和 关闭 音乐 。 

日 常生 活 中 收听 收音 机 就 是 一 种 广播 通信 机 制 .在 收音 机 中 有 很 多 个 广播 电台 ,每 个 
广播 电台 播放 的 内 容 都 不 相同 ,广播 电台 (发 送 方 ) 并 不 在 意 听 众 (接收 方 ) 接 收 到 广播 时 
如 何 处 理 广 播 内 容 。 例 如 ,广播 电台 会 广播 当前 的 交通 状况 ,但 它 并 不 关心 司机 等 听众 接 
收 到 广播 时 如 何 做 出 处 理 ,这 不 是 广播 应 该 关心 的 问题 。 Android 系统 中 的 广播 机 制 和 
日 常生 活 中 的 广播 非常 类 似 。Android 系统 的 广播 系统 由 发 送 广播 的 应 用 程序 .接收 广 
播 的 应 用 程序 和 意图 组 成 。 意 图 是 广播 的 内 容 , 尽 管 每 条 广播 的 内 容 各 异 ,但 却 可 以 将 不 
同 广播 划分 成 各 个 类 别 ,这 个 类 别 用 意图 对 象 的 动作 属性 表示 ,具有 相同 动作 属性 值 的 意 
图 属 同一 类 广播 。 发送 广 播 的 程序 只 关心 发 送 什么 内 容 , 它 不 关心 谁 会 处 理 和 如 何 处 理 
这 个 广播 内 容 . 接 收 广播 的 程序 只 关心 广播 内 容 . 它 不 关心 是 哪个 应 用 程序 发 送 的 广播 ， 
两 者 互相 不 需要 知道 对 方 的 存在 的 。 

Android 系统 的 广播 种 类 众多 .广播 发 送 者 是 如 何 发 送 广 播 以 及 广播 接收 者 是 如 何 
接收 自己 关心 的 广播 呢 ? 脚本 应 用 发 送 广 播 相对 简单 些 . 只 需要 调用 SL4A 提供 的 广播 
方法 就 可 把 广播 发 送出 去 。 而 脚本 应 用 要 接收 广播 首先 需要 注册 广播 ,只 有 注册 某 类 广 
播 才 能 接收 此 类 广播 .否则 即使 系统 发 送 了 此 类 广播 .但 脚本 应 用 仍然 会 接收 不 到 此 类 广 
播 。 由 于 广播 由 意图 对 象 表示 ,因此 注册 某 类 广播 时 需要 指定 广播 意图 对 象 的 动作 值 .这 
个 动作 值 代表 此 类 广播 。 其 次 ,脚本 应 用 还 要 经 常 主动 监听 事件 . 当 监 听 到 “自己 关心 "的 
广播 事件 时 .就 从 广播 事件 中 解析 和 操纵 广播 数据 。 脚 本 应 用 如 果 不 再 关心 某 类 广播 .就 
应 该 及 时 注销 广播 。 最 后 脚本 应 用 要 注销 广播 以 此 避免 接收 到 自己 不 关心 的 广播 。 


8.3.2 广播 的 注册 和 启动 
下 面 是 广播 发 送 、 注 册 、 注 销 和 监听 等 方法 的 具体 定义 。 


sendBroadcast ((String action, String uri (optional), String type (optional), JSONObject 


extras (optional), String packagename (optional), String classname (optional))) 


其 作用 是 发 送 广 播 . 这 些 参数 表示 广播 的 内 容 .分 别 表示 广播 的 动作 、 数 据 、 数 据 类 
型 .附加 数据 ` 包 名 和 类 名 。 
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sendBroadcastIntent (Intent intent) 


其 作用 是 用 意图 对 象 发 送 广播 .参数 intent 表示 广播 的 内 容 ,用 意图 对 象 表示 .可 用 
方法 makeIntent 创建 意图 对 象 。 


eventRegisterForBroadcast (String category, Boolean enqueue) 


其 作用 是 注册 广播 .参数 category 表示 广播 类 别 或 名 称 ,这 个 类 别 用 字符 串 表 示 . 可 
以 是 系统 自 定 的 意图 动作 字 串 符 , 也 可 以 是 用 户 自 定义 的 字符 串 . 其 含义 应 该 要 明确 , 参 
数 enqueue 是 布尔 值 . 当 值 为 true 表示 把 广播 立即 进行 分 发 .否则 加 到 消息 队列 中 .其 默 
认 值 为 true. 该 参数 是 可 选 的 。 


eventUnregisterForBroadcast (String category) 


其 作用 是 停止 监听 广播 .参数 category 表示 停止 监听 广播 的 类 别 ( 或 名 称 ) 。 


eventGetBrodcastCategories() 


其 作用 是 列 出 所 有 监听 的 广播 列表 。 


eventWait (Integer timeout [optional]: the maximum time to wait) 


其 作用 是 等 待 广播 事件 的 到 来 .参数 timeout 表示 等 待 的 最 大 时 间 ,单位 为 ms, 该 参 
数 可 选 ,如 果 未 指定 该 参数 则 永远 等 待 直到 有 事件 到 来 ,方法 会 返回 关联 数组 ,数组 包含 
事件 .返回 的 事件 将 从 事件 队列 中 删除 。 

例 8-4 是 广播 范例 , 例 中 会 监听 分 钟 变化 广播 和 显示 广播 的 内 容 。 例 中 先 注册 了 广 
播 "android. intent. action. TIME_TICK”. Android 系统 每 隔 一 分 钟 会 发 送 一 次 这 个 广 
播 ; 然 后 监听 这 个 广播 事件 .由 于 监听 的 时 间 是 70s. 所 以 在 一 分 钟 内 一 定 会 接收 到 这 个 
广播 ,但 广播 在 一 分 钟 内 的 到 来 时 间 是 不 确定 的 ;最 后 显示 广播 的 内 容 。 

【 例 8-4】 (代码 位 置 : \8\testBroadcast. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android=new Android () ; 

/* 注 册 广 播 或 插 拔 耳机 时 触发 ,事件 中 的 data 数据 是 对 象 ， 

对 象 包 括 state .action microphone 和 name 等 属性 

category= “android. intent. action. HEADSET_PLUG”; 


*/ 

//category= “android. intent.action. SCREEN_OFF”; // 关 闭 屏幕 时 触发 
//category= "android. intent. action. SCREEN_ON”; // 打 开 屏 幕 时 触发 
// 分 钟 发 生变 化 时 触发 ， 


var category= “android. intent. action. TIME TICK” ; 


var ret=android. eventRegisterForBroadcast (category , false); // 注 册 广 播 
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//java. lang. Thread. sleep (1000) ; ; 


var ret=android. eventWait (70000 ) ; //70 秒 内 一 定 会 产生 一 个 分 钟 变换 事件 
android. eventUnregisterForBroadcast (category) : // 注 销 广 播 

ret=ret. data; // 获 取 广 播 数据 

android. dialogCreateAlert (“参数 data”, ret ); // 显 示 广 播 内 容 


android. dialogSetPositiveButtonText (“OK”):; 
android. dialogSetNegativeButtonText (“CANCEL”); 
android. dialogShow(); 


android. dialogGetResponse(); 


图 8-1 是 运行 结果 ,结果 显示 广播 携带 的 动作 
参数 data 值 为 “android. intent. action. TIME_TICK”, 携带 
fraction'"android inte VE 的 extras 包括 一 个 键 值 对 , 键 名 为 “android. 
OUNTY :ALARN intent, extra_ALARM_COUNT”, 键 值 为 1。 例 中 

还 提供 了 耳机 、 关 开 屏 幕 广 播 , 读 者 可 行 修改 代码 


| we | = | 进行 测试 ,但 耳机 应 该 要 监听 两 次 事件 ,因为 耳机 


广播 在 注册 时 就 会 产生 事件 , 插 拔 耳 机 时 也 会 产生 
图 8-1 广播 内 容 事件 。 





8.3.3 常见 系统 广播 


Android 系统 提供 了 很 多 标准 的 系统 广播 .比如 屏幕 关闭 和 电池 电量 低 等 广播 。 广 
播 类 别 用 意图 对 象 的 动作 属性 值 表示 , 表 8-4 列 出 了 系统 定义 的 广播 意图 类 别 。 


表 8-4 系统 广播 类 别 















































广播 动作 字符 串 (action 属性 值 ) 广播 含义 
android. intent. action. SERVICE_STATE 电话 服务 的 状态 已 经 改变 
android. intent. action. 时 区 已 经 改变 
android. intent. action. 时 间 已 经 改变 (重新 设置 ) 
android. intent. action. TIME_TICK 当前 时 间 已 经 变化 (正常 的 时 间 流 逝 ) 
android. intent. action. UMS_CONNECTED 设备 进入 USB 大 容量 存储 模式 
android. intent. action. UMS_DISCONNECTED 设备 从 USB 大 容量 存储 模式 退出 
android. intent. action. WALLPAPER_CHANGED | 系统 的 墙纸 已 经 改变 
android. intent. action. XMPP_CONNECTED XMPP 连接 已 经 被 建立 
android. intent. action. XMPP_DI XMPP 连接 已 经 被 断 开 
android. intent. action. SIG_STR 电话 的 信号 强度 已 经 改变 
android. intent. action. BATTERY_CHANGED 充电 状态 ,或 者 电池 的 电量 发 生变 化 
android. intent. action. BOOT_ COMPLETED 在 系统 启动 后 .这 个 动作 被 广播 一 次 (只 有 一 次 ) 
android. intent. action. DATA_ACTIVITY 电话 的 数据 活动 (data activity) 状 态 已 经 改变 
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续 表 
广播 动作 字符 串 (action 属性 值 ) 广播 含义 
android. intent. action. DATA_STATE 电话 的 数据 连接 状态 已 经 改变 
android. intent. action. DATE_CHANGED 日 期 被 改变 
android. server. checkin. FOTA_CANCEL 取消 所 有 被 挂 起 的 (pending) 更 新 下 载 
android. server. checkin. FOTA_INSTALL 更 新 已 经 被 确认 ,马上 就 要 开始 安装 
android. server. checkin. FOTA_READY 更 新 已 经 被 下 载 ,可 以 开始 安装 
android. server. checkin. FOTA_RESTART 恢复 已 经 停止 的 更 新 下 载 
android. server. checkin. FOTA_UPDATE 通过 OTA 下 载 并 安装 操作 系统 更 新 





android. intent. 


action. MEDIABUTTON 


用 户 按 下 了 Media Button 





android. intent. 


action. MEDIA_BAD REMOVAL 


扩展 卡 从 SD 卡 插 槽 拔 出 ,但 是 挂 载 点 还 没 被 
解除 (unmount) 











android. intent. action. MEDIA_EJECT 用 户 想 要 移 除 扩展 介质 ( 拔 掉 扩 展 卡 ) 
android. intent. action. MEDIA_MOUNTED 扩展 介质 被 插入 ,而且 已 经 被 挂 载 
android. intent. action. MEDIA_REMOVED 扩展 介质 被 移 除 





android. intent. action. MEDIA_SCANNER_FINISHED 


已 经 扫描 完 介质 的 一 个 目录 





android. intent. action. MEDIA_SCANNER_STARTED 


开始 扫描 介质 的 一 个 目录 





android. intent. 


action. MEDIA_SHARED 


扩展 介质 的 挂 载 被 解除 (unmount) 





android. intent. 


action. MEDIA_UNMOUNTED 


扩展 介质 存在 ,但 是 还 没有 被 挂 载 (mount) 





android. intent. 


action. MWI 


电话 的 消息 等 待 (语音 邮件 ) 状 态 已 经 改变 





android. intent. 


action. PACKAGE_ADDED 


设备 上 新 安装 了 一 个 应 用 程序 包 





android. intent. 


action. PACKAGE _ REMOVED 


设备 上 删除 了 一 个 应 用 程序 包 





android. intent. 


action. PHONE_STATE 


电话 状态 已 经 改变 





android. intent. 


action. PROVIDER_CHANGED 


更 新 将 要 (真正 ) 被 安装 





android. intent. 


action. PROVISIONING_CHECK 


要 求 provisioning service 下 载 最 新 的 设置 





android. intent. 


action. SCREEN_OFF 


屏幕 被 关闭 





android. intent. 


action. SCREEN_ON 


屏幕 已 经 被 打开 





android. intent. 
RECEIVED 


action. NETWORK_ JICKLE_ 


设备 收 到 了 新 的 网 络 tickle 通知 





android. intent. 


action. STATISTICS REPORT 


要 求 receivers 报告 自己 的 统计 信息 





android. intent. 


action. STATISTICS STATE_ 








i 态 
CHANGED 统计 信息 服务 的 状态 已 经 改变 
android. intent. action. CFF 语音 电话 的 呼叫 转移 状态 已 经 改变 
android. intent action. CONFIGURATION_CHANGED | 设备 的 配置 信息 已 经 改变 
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8.4 内 容 


8.4.1 内 容 是 什么 


Content 中 文 翻译 为 内容”. 它 是 Android 系统 4 大 组 件 之 一 .也 是 一 种 数据 通信 机 
制 。Content 的 一 个 主要 作用 是 提供 统一 的 方法 在 不 同 应 用 之 间 存 储 和 共享 数据 。 在 
Android 系统 中 ,不 存在 一 个 公共 的 数据 存储 区 供 所 有 的 应 用 程序 访问 ,也 就 是 说 数据 在 
各 个 应 用 程序 中 是 私有 的 。 尽 管 Android 系统 提供 了 首选 项 .文件 .SQLite 数据 库 和 网 
络 等 数据 存储 技术 ,但 Android 应 用 数据 的 私有 性 决定 了 这 些 存储 技术 不 可 以 在 应 用 程 
序 之 间 存 储 和 共享 数据 。 就 算 使 用 其 他 方法 也 可 以 对 外 共享 数据 ,但 数据 访问 方式 也 会 
因数 据 存储 的 方式 而 不 同 。 例 如 .文件 共享 数据 需要 文件 I/O 方法 操作 ,采用 首选 项 共 
享 数 据 需 要 使 用 首选 项 方法 读 写 数据 。 而 使 用 Content 共享 数据 可 以 统一 数据 访问 
方法 。 

如 何 使 用 Content 在 一 个 应 用 程序 中 访问 另 一 个 应 用 程序 中 的 数据 呢 ? Content 通 
信和 由 内 容 提供 者 和 内 容 使 用 者 组 成 ,作为 内 容 提 供 者 的 应 用 程序 负责 暴露 自己 的 数据 供 
其 他 应 用 程序 使 用 ,作为 内 容 使 用 者 的 其 他 应 用 程序 通过 统一 的 方法 使 用 暴露 的 数据 , 没 
有 暴露 的 数据 是 不 可 以 访问 的 。 无 论 暴 露 的 数据 是 什么 ,都 可 以 使 用 统一 的 URI 描述 数 
据 。 内 容 使 用 者 可 以 通过 这 个 URI 来 寻 址 访问 内 容 。 内 容 请 求 数据 的 URI 形式 如 下 
所 示 。 


content://authority/path/id 


其 中 ,“content://" 是 内 容 的 标准 前 级 。authority 是 主机 名 或 提供 者 名 称 , 建 议 使 用 
完整 的 包 名 称 .避免 出 现 内 容 提供 者 的 名 称 冲突 。path 是 提供 者 内 部 的 一 个 路 径 名 ,为 
了 安全 使 用 的 是 虚拟 路 径 名 , 它 用 于 标识 请 求 数据 的 存储 区 域 。id 是 请 求 数据 的 主键 。 
例如 “content://media/internal/images” 这 个 URI 表示 返回 设备 上 的 所 有 联系 人 信息 ， 
其 中 “content://”" 是 前 辍 .“media” 是 包 名 .“internal/images” 是 虚拟 目录 。 再 例如 . 
“content://contacts/people/45” 表 示 返 回 联 系 人 应 用 中 id 为 45 的 联系 人 信息 。 需 要 注 
意 的 是 ,这 里 并 没有 使 用 标准 的 authority 结构 .因为 “contacts”" 和 “media” 并 不 是 第 三 方 
的 内 容 提供 者 .而 是 由 Android 内 置 的 提供 者 。 


8.4.2 ”内容 的 查询 


关于 内 容 .SL4A 并 没有 提供 暴露 数据 和 访问 暴露 数据 的 方法 。 但 通过 意图 .应 用 程 
序 可 以 查询 应 用 程序 已 暴露 的 数据 。 具 体 查 询 的 方法 是 在 原 应 用 中 设置 意图 动作 值 为 
“android. intent. action. GET_CONTENT”, 这 类 意图 会 启动 提供 内 容 的 应 用 .用 户 选 择 
具体 的 内 容 之 后 .提供 内 容 的 应 用 会 以 *content://” 等 形式 把 数据 返回 给 原 应 用 。 下 面 
是 关于 内 容 的 实例 ,. 例 中 通过 意图 访问 “content://media/external/audio/media/96039”， 
这 个 URI 指明 提供 者 是 第 三 方 应 用 media 程序 .音频 文件 存储 在 虚拟 路 径 “external/ 
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audio/media” ,id 是 音频 文件 的 标识 符 : 此 处 其 值 为 96039, 这 个 值 需 要 根据 实际 的 值 设 
置 。 如 果 id 值 正常 , 则 程序 运行 后 会 提示 用 户 选择 播放 器 程序 播放 对 应 的 音频 文件 , 否 
则 不 能 正常 播放 音频 文件 。 为 便于 测试 ,可 以 另 写 程序 设置 意图 动作 值 为 “android. 
intent. action. GET_CONTENT” 启 动 音乐 内 容 提供 应 用 程序 查看 音频 文件 的 id 值 。 

【 例 8-5】 (代码 位 置 : \8\testContent. php) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 

var android= new Android(); 

var action= “android. intent. action. VIEW”; 

var uri= “content://media/external/audio/media/96039”; // 播 放 暴 露出 来 的 音乐 文件 
var ret=android. startActivityForResult (action ,uri ); 


8.4.3 联系 人 内 容 


为 了 阐明 文件 .首选 项 和 网 络 等 方式 存储 的 数据 可 以 通过 统一 的 Content 方法 暴露 
和 访问 数据 ,在 此 以 联系 人 应 用 为 例 讲述 其 数据 库存 储 方式 和 对 应 的 Content 读 取 方式 。 
系统 联系 人 应 用 会 把 联系 人 数据 存储 在 指定 的 数据 库 文件 中 ,这 个 文件 一 般 存 放 在 路 径 
“/data/ data/com. android. providers. contacts/ databases/contacts2. db” 中 。 先 通过 命令 
把 这 个 contacts2. db 文件 导出 到 PC 端 ,再 通过 SQLite 工具 来 查看 数据 库 ,最 后 根据 查 
看 到 的 数据 设置 Content 的 URI, 应 用 程序 通过 这 个 URI 访问 数据 库 中 的 数据 。 数 据 库 
导出 命令 如 下 所 示 。 


adb pull /data/data/com. android. providers. contacts/databases/contacts2. db contacts2. db 


这 个 库 文件 中 含有 多 个 和 联系 人 相关 干 的 数据 库 表 , 表 8-5 和 表 8-6 列 出 了 表 data 
和 表 raw_contacts 的 主要 字段 。 


表 8-5 表 data 主要 字段 





raw_contact id 通过 raw_contact id 可 以 找到 raw_contact 表 中 相对 的 数据 


字段 里 保存 着 联系 人 的 信息 .联系 人 名 称 、 联 系 人 电话 号 码 .电子 邮件 和 备注 
等 信息 ,其 中 ,字段 data4 对 应 电话 号 码 





datal 一 datal5 





表 8-6 ” 表 raw_contacts 主要 字段 














人 
version 联系 人 修改 次 数 
deleted 删除 标志 . 0 为 默认 ,1 表示 这 行 数据 已 经 删除 
display_name 联系 人 名 称 
LE 最 后 联系 的 时 间 








通过 SQLiteManager 等 工具 打开 PC 端的 数据 库 文 件 contacts2. db, 会 发 现存 在 
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contacts、data 和 raw_contacts 等 20 张 表格 。contacts 是 联系 人 表 . data 是 联系 人 子 表 ， 
raw_contacts 是 原始 联系 人 表 。 打 开 表 raw_contacts 和 表 data 观察 里 面 的 数据 项 值 , 然 
后 把 下 列 代码 中 的 "17 修改 为 表 raw_contacts 中 的 _id 字段 值 。 运 行 本 例 程序 后 会 自动 
打开 联系 人 应 用 和 显示 联系 人 信息 。 比 较 联系 人 应 用 显示 的 联系 人 信息 和 数据 库 中 对 应 
的 联系 人 信息 ,比较 后 会 发 现 两 者 信息 一 致 。 这 表明 通过 Content 可 以 访问 联系 人 数据 


库 中 的 数据 。 


load("/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var android= new Android(); 
var action= “android. intent. action. VIEW”; 


var uri= “content://contacts/people/1”; 


// 设 置 为 表 raw_contacts 中 的 ”id” 字 段 值 


var ret=android. startActivityForResult (action , uri ); 


8.4.4 系统 提供 的 内 容 


Android 系统 是 标准 内 容 提供 者 ,提供 者 类 包含 在 包 android. provider 中 。 尽 管 
SL4A 并 不 能 够 直接 访问 提供 者 类 ,但 通过 格式 为 content:\\” 的 意图 可 以 访问 提供 者 对 
外 暴露 的 数据 。 表 8-7 列 出 了 部 分 标准 内 容 提供 者 。 


表 8-7 内 容 提供 者 

















提供 者 类 content 格式 说 明 
Browser content://browser 例如 书签 内 容 content://browser/bookmarks 
Contacts content://contacts 联系 人 content://contacts/people 
存储 在 SD 扩展 卡 上 的 图 片 、 视 频 和 音频 内 容 。 
片 content://media/external/images/media/id 值 ; 
MediaStore content://media ed 
视频 content://media/external/video/media/id 值 ; 
音频 content://media/external/audio/media/id 值 
Settings content://settings 
CallLog content://call log/ | 拨打 电话 content://call log/calls 





CalendarContract 





UserDictonary 








85 后 台 服 务 


Service 中 文 翻译 为 服务 .服务 是 指 在 Android 系统 后 台中 运行 的 组 件 . 它 通常 没有 
用 户 界面 。 后 台 服 务 主要 用 来 处 理 一 些 不 干扰 用 户 使 用 的 后 人 台 操 作 . 例 如 下 载 文件 和 播 
放 音 乐 等 。 如 果 后 台 服 务 要 和 具有 UI 界面 的 活动 进行 交互 .那么 它们 需要 通过 发 送 广 
播 等 方式 进行 通信 。 后 台 服 务 会 一 直 保持 可 用 状态 :但 它 无 须 主动 执行 后 台 服 务 操 作 。 
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如 果 要 启动 后 台 服 务 提供 的 操作 ,通常 需要 通过 发 送 意图 来 实现 。 例 如 ,音乐 播放 器 可 以 
有 界面 也 可 以 在 没有 界面 状态 下 播放 音乐 .播放 音乐 由 后 台 服 务实 现 , 通 过 播放 器 界面 可 
以 控制 停放 音乐 .播放 器 通过 意图 向 后 台 服 务 发 送 消息 通知 其 停放 音乐 。 由 于 SL4A 没 
有 提供 后 人 台 服 务 支持 :本文 在 此 不 深入 阐述 此 服务 .有 兴趣 的 读者 请 参看 Android Java 
相关 资料 。 
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9.1 通用 任务 


9.1.1 一 维 码 和 二 维 码 扫描 


为 快速 识别 物品 的 重要 信息 ,条形码 被 广泛 应 用 于 商业 、 邮 政 、 图 书 管理 仓储、 工业 
生产 过 程控 制 和 交通 等 领域 ,包括 仓库 管理 系统 、 物 流 配送 系统 、 商 业 POS 系统 、 药 品 监 
管 系统 、 图 书 管理 系统 、 图 书 采购 软件 .生产 现 场 管理 系统 和 食品 溯源 系统 等 。 条 形 码 英 
文 名 为 Barcode, 其 起 源 于 20 世纪 40 年 代 , 应 用 于 20 世纪 70 年 代 , 普 及 于 20 世纪 80 年 
代 。 条 形 码 可 分 为 一 维 条 码 (One Dimensional Barcode.1D) 和 二 维 码 (Two Dimensional 
Code,2D) 两 大 类 。 

由 于 商品 中 的 条 形 码 以 一 维 条 码 为 主 .所 以 一 维 条 码 又 被 称 为 商品 条 码 。 一 维 条 码 
由 一 组 纵向 的 黑 条 (简称 条 ) 和 白条 (简称 空 ) 组 成 .每 组 黑白 条 间隙 宽度 和 黑白 条 粗细 宽 
度 是 不 同 的 ,黑白 条 按照 一 定 的 编码 规则 排列 ,用 以 表达 一 组 信息 的 标识 符 。 也 可 以 这 样 
理解 ,一 维 条 码 是 利用 黑白 条 的 宽窄 和 黑白 条 间隔 宽窄 构成 二 进 制 的 “0" 和 “1”, 并 用 “0” 
和 “1” 的 组 合 来 表示 某 个 数字 或 字符 ,以 此 来 反映 某 种 信息 。 通 常 一 维 条 码 下 方 还 会 有 英 
文字 母 或 阿拉 伯 数 字 。 一 维 条 码 只 可 表示 英文 .数字 和 简单 符号 等 字符 ,而且 其 所 携带 的 
信息 量 非常 有 限 , 并 不 能 提供 商品 更 详细 的 信息 .要 查询 更 多 的 商品 信息 .需要 把 一 维 条 
码 所 携带 的 信息 传递 给 计算 机 ,由 计算 机 在 预先 建立 的 商品 数据 库 中 查询 商品 信息 。 一 
维 条 码 之 所 以 由 黑 条 和 白条 组 成 图 案 , 这 是 因为 黑白 条 的 反射 率 相差 很 大 有 助 于 提高 识 
别 率 。 

二 维 码 也 叫 二 维 条 码 或 二 维 条 形 码 。 二 维 码 是 一 种 用 某 种 特定 的 几何 图 形 在 平面 
(二 维 方向 上 ) 按 一 定 规律 摆 放 的 黑白 相间 方 阵 图 形 . 方 阵 图 形 记录 了 数据 符号 信息 。 二 
维 码 可 以 印刷 在 报纸 、 杂 志 , 广 告 . 图 书 、 包 装 以 及 个 人 名 片 等 多 种 载体 上 .用户 通 过 手机 
摄像 头 扫描 二 维 码 即 可 实现 快速 手机 上 网 和 便捷 地 浏览 网 页 、 下 载 图 文 、 音 乐 、 视 频 、 获 取 
优惠 券 、 参 与 抽奖 和 了 解 企 业 产 品 信 息 . 省 去 了 在 手机 上 输入 URL 的 烦琐 过 程 。 常 用 的 
二 维 码 码 制 有 PDF417 二 维 条 码 、Datamatrix 二 维 条 码 、Maxicode 二 维 条 码 .QR Code、 
Code 49、Code 16K 和 Code one 等 。QR Code 码 是 由 日 本 丰田 子 公司 Denso Wave 于 
1994 年 9 月 研制 的 一 种 矩阵 二 维 码 符号 .QR 是 英文 Quick Response 的 缩写 , 即 快速 反 
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应 的 意思 , 源 自发 明 者 希望 QR 码 可 让 其 内 容 快 速 被 解码 。QR 码 比 普 通 条 码 可 储存 更 
多 资料 ,也 无 须 像 普通 条 码 般 在 扫描 时 需 直 线 对 准 扫描 器 。QR 码 所 携带 的 数据 量 较 大 、 
参照 最 大 规格 符号 版 本 40-L 级 .QR 码 可 容纳 多 达 4292 个 大 小 写 英 文字 母 或 7089 个 数 
字 或 2953 个 字 节 或 1817 个 汉字 。QR 码 有 L、M\Q 和 HH 4 个 容错 级 别 ,L 级 为 7% 容 
错 ,M 级 为 15% 容 错 .Q 级 为 25% 容 错 , HH 级 为 75% 容 错 。QR 用 深 色 模块 表示 二 进 制 
“1”, 用 浅 色 模块 表示 二 进 制 *0”。QR 码 支 持 的 信息 格式 有 文本 、 电 话 号 码 、 短 信 、 名 片 、 
电子 邮件 .网 址 .无 线 网 络 . 日 程 安排 等 。 为 何 用 手机 扫描 一 个 网 址 二 维 码 后 会 先 跳出 一 
个 网 址 对 话 框 呢 ? 这 是 出 于 扫描 软件 对 用 户 的 保护 所 导致 的 , 它 会 先 让 用 户 判断 这 个 网 
址 是 否 安全 ,由 用 户 决 定 是 否 继续 访问 网 址 。 随 着 智能 手机 的 普及 . QR 码 成 为 一 个 快 
速 、 高 效 的 URL 连接 器 .被 称 为 移动 互联 网 的 "入口 "。 尽 管 QR 码 作为 目前 被 广泛 使 用 
的 二 维 码 , 但 它 为 用 户 带 来 便捷 的 同时 ,也 成 为 恶意 软件 .网 络 钓鱼 等 攻击 的 携带 者 和 传 
播 者 。 

一 维 码 和 二 维 码 相 比较 ,一 维 码 具 有 关 技 术 成 熟 、. 使 用 广泛 .携带 信息 量 少 . 只 支持 英 
文 或 数字 和 设备 成 本 低廉 等 优点 ,但 需 与 计算 机 数据 库 结合 才能 发 挥 作用 ,否则 所 携带 的 
数据 将 没有 意义 。 二 维 码 具有 信息 容量 大 ,保密 性 高 .编码 范围 广 . 译 码 可 靠 性 高 . 纠 错 能 
力 强 .成 本 便宜 等 特性 .但 目前 也 暴露 出 安全 性 等 问题 。SL4A 提供 scanBarcode 接口 用 
来 扫描 一 维和 二 维 码 , 下 面 是 接口 定义 。 


scanBarcode() 


其 功能 是 扫描 一 维和 二 维 码 ,并 以 意图 对 象 数据 类 型 返回 扫描 结果 .意图 对 象 包 

插 action categories ,flags 和 extras 属性 ,其 中 ,extras 是 对 象 数据 类 型 .其 他 为 字符 串 

数据 类 型 。action 是 扫描 一 维 码 和 二 维 码 应 用 的 包 名 。 如 果 扫 描 图书 一 维 码 ,那么 

对 象 extras 将 带 有 SCAN_RESULT_FORMAT 和 SCAN_RESULT 属性 ,分 别 表 示 

书 一 维 码 的 编码 和 书 的 ISBN。 如 果 扫 描 的 是 二 维 码 .那么 对 象 extras 将 带 有 SCAN 

_RESULT_BYTE_SEGMENTS 0.SCAN_ RESULT_ FORMAT.SCAN_RESULT __ 
ERROR_CORRECCTION_LEVEL.SCAN_RESULT_BYTES 和 SCAN_RESULT 等 

属性 。SCAN_RESULT 表示 扫描 到 的 内 容 . 内 容 类 型 和 内 容 格 式 如 表 9-1 所 示 。 

SCAN_RESULT_FORMAT 表示 二 维 码 编码 , 值 QR_CODE 表示 QR 编码 。SCAN__ 
RESULT_ERROR_CORRECCTION_LEVEL 表示 容错 级 别 . 它 有 L、M.Q 和 HH14 个 

容错 值 。 


表 9-1 SCAN RESULT 数据 格式 








内 容 类 型 数据 格式 实 例 
手机 tel: 手 机 号 tel:13912345678 
文本 没有 格式 HELLO 
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续 表 
内 容 类 型 数据 格式 实 例 
BEGIN:VCARD i RD 
1: y 
本 全 二 本 性 天 ORG: 北京 XX 公司 
后生 120: 局 性 让 TITLE: 销售 经 理 
de TEL: 13911111111 
联系 人 END: VCARD Es 
URL: http://www. xxx. com 
EMAIL: zs@xxx. com 
MECARD: 属性 1: 属性 值 ;属性 2: 属性 值 ; | ADR: 北京 市 海淀 区 TT 路 
属性 n: 属性 值 NOTE: 无 备注 
END: VCARD 
WiFi WIFI: S: 网 络 名 称 ;T: 密 钥 类 型 ;P: 密码 | WIFI: S: mywifi;T: WPA;P: 123456 
邮箱 mailto: 邮箱 mailto:no@ baidu. com 
网 址 URL http://www. baidu. com 
BEGIN:VEVENT 
BEGIN: VEVENT SUMMARY : 周 例会 
属性 1: 属性 值 DTSTART: 20151010T080000Z 
日 历 属性 2: 属性 值 DTEND: 20151010T170000Z 
属性 n: 属性 值 LOCATION: 会 议 室 
END: VEVENT DESCRIPTION: 组 织 改 选 
END:VEVENT 
短 消息 smsto: 手机 号 码 : 短 消息 内 容 smsto: 13911111111: 这 是 短 消息 
地 理 坐 标 | geo: 纬度 ;经 度 geo: 1: 0 








例 9-1 是 扫描 图 书 一 维 码 的 应 用 , 它 会 以 列表 呈现 一 维 码 扫描 结果 。 
【 例 9-1〗 〈 代 码 位 置 : \9\testScanBarcode. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”):; 
var droid= new Android(); 

var obj= droid. scanBarcode () ; 

var items=new Array(); 

items[0]=“action 属性 :\n”+obj. action; 

items[1]=“categories 属性 :\n”+obj. categories; 

items[2]=“flags 属性 :\n”+obj. flags; 

items[3]=“[extras]SCAN_RESULT 属性 :\n“+obj. extras. SCAN_RESULT; 
items[4]=“[extras]SCAN_RESULT_FORMAT 属性 : \n“+ obj. extras. SCAN_RESULT_FORMAT; 
droid. dialogCreateAlert (“列表 ); 

droid. dialogSetItems (items) ; 
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droid. dialogShow() ; 


var response= droid. dialogGetResponse(); 


运行 程序 之 前 先 确保 手机 已 连接 好 WiFi 网 络 和 已 安装 好 BarcodeScanner 类 应 用 。 程 
序 运行 时 会 自动 启动 BarcodeScanner 类 应 用 .用 BarcodeScanner 类 应 用 扫描 图 书 的 一 维 码 ， 
程序 会 显示 出 一 维 码 的 相关 信息 。 图 9-1 是 扫描 图 书 一 维 码 的 运行 结果 ,其 中 ,图 9-1(a) 是 
图 书 一 维 码 .图 9-1(b) 是 扫描 结果 。action 值 表明 扫描 一 维 码 的 BarcodeScanner 类 应 用 
是 软件 zxing, 书 的 ISBN 是 “9787302364580”, 这 个 ISBN 就 是 一 维 码 呈 载 的 信息 ,一 维 码 
的 码 制 是 "EAN_13”。 


action 属 性 
com.google zxing.client.a 
ndroid.SCAN 

ISBN 978-7-302-36458-0 


[extrasjSCANLRESULT 属 
性 

9787302364580 
[extrasJSCAN_RESULT_FO 
RMAT 属 性 


P37302l364580l> | eA 
(a) 


catlegories 属 性 





图 9-1 图 书 一 维 码 


9.1.2 浏览 任务 


尽管 Android 的 资源 类 型 各 式 各 样 , 但 都 可 以 使 用 统一 的 URI 进行 描述 。 有 了 统一 
的 URI, 用 户 只 需 通 过 URI 告诉 Android 系统 要 浏览 资源 ,Android 系统 会 智能 地 为 用 
户 选 择 适 当 的 应 用 打开 资源 进行 浏览 .而 无 须 事先 打开 应 用 再 打开 资源 进行 浏览 。 如 果 
URI 无 法 描述 资源 的 类 别 . 则 需 声明 资源 的 MIME 类 别 ,Android 系统 会 根据 这 个 
MIME 类 别 使 用 合适 的 应 用 打开 资源 。 如 果 打 开 的 资源 可 以 附带 数据 , 则 需 指定 extras 
值 ,例如 .发 送 邮 件 可 以 附加 附件 .再 比如 发 短 消息 可 以 附加 短信 内 容 。 表 9-2 列 出 了 一 
些 常用 资源 的 URI。 


表 9-2 常用 资源 URI 描述 

















资源 名 称 URI 格式 MIME 类 型 extras 实 例 
网 站 URL http://www. baidu. com/ 
地 图 经 纬度 | geo: 纬 度 ,经 度 geo:52.76,-79. 0342 
电话 号 码 tel: 电 话 号 码 tel:10086 
邮件 mailto: 邮 箱 
短 消 息 smsto: 手 机 号 码 | vnd. android-dir/mms-sms 
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续 表 
资源 名 称 URI 格式 MIME 类 型 extras 实 例 
播放 音频 file:///sdcard/ download/ 
audio/mp3 
文件 everything. mp3 
文本 文件 text/plain 
vmv 文件 audio/x-ms-wmv 
vma 文件 audio/x-ms-wma 
jpeg 文件 image/jpeg 
html 文 件 text/html 
3gp 文件 video/3gpp 
avi 文 件 video/ x-msvideo 
一 一 一 一 | file:// 本 地 文件 
doc 文件 application/msword 
pplication/ vnd. openxml 
docx 文件 formats-officedocument. 
wordprocessingml. document 
xls 文件 application/ vnd. ms-excel 
js 文件 application/ x-javascript 
ppt 文件 application/ vnd. ms-powerpoint 
application/ vnd. openxmlformats- 
pptx 文件 officedocument. presentationml 








. presentation 








SL4A 提供 了 统一 的 方法 view 用 于 浏览 资源 ,下 面 是 view 方法 的 定义 。 


view(String uri, String type, JSONObject extras) 


其 作用 是 使 用 意图 启动 应 用 打开 指定 资源 ,参数 uri 是 资源 的 URI. 参 数 type 是 资源 的 
MIME 类 型 ,该 参数 可 选 .参数 extras 是 指 附加 到 意图 中 的 extras 属性 .是 意图 传递 给 应 用 


的 附加 数据 。 
9.1.3 联系 人 列表 浏览 


尽管 随 着 科技 的 进步 .智能 手机 的 功能 越 来 越 强大 .但 智能 手机 最 常用 最 重要 的 仍然 是 
电话 、 联 系 人 和 短信 功能 。Android 获取 手机 电话 簿 中 的 联系 人 列表 有 两 种 常用 的 方法 .第 
一 种 方法 是 直接 操作 电话 筹 中 的 联系 人 数据 库 . 第 二 种 方法 是 通过 应 用 操作 联系 人 。 联 系 
人 电话 筹 应 用 的 安全 性 、 便 捷 性 和 高 效 性 等 是 影响 手机 用 户 是 否 继续 使 用 手机 设备 的 重要 
因素 。 如 果 要 开发 一 个 具有 安全 性 、 便 捷 性 和 用 户 体 验 良好 的 联系 人 应 用 .就 可 以 选用 第 一 
种 方法 对 联系 人 数据 库 里 的 数据 进行 加 密 等 操作 。 如 果 Android 应 用 仅仅 是 提供 联系 人 查 
看 功能 ,可 以 把 Android 内 置 的 联系 人 应 用 集成 进来 ,这样 Android 应 用 就 拥有 了 一 个 联系 
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人 相关 的 功能 .这 种 方法 的 特点 是 比较 简单 .但 功能 等 会 受 内 置 联系 人 应 用 的 限制 。 
SL4A 提供 了 联系 人 列表 浏览 方法 viewContacts, 方 法 被 调用 后 会 打开 手机 联系 人 应 
用 ,这 个 应 用 提供 显示 、 排 序 、 查 找 、 添 加 、 删 除 和 更 新 联系 人 等 功能 ,方法 viewContacts 
定义 如 下 所 示 。 


viewContacts() 


该 方法 的 作用 是 打开 内 置 电 话 簿 应 用 供用 户 浏览 联系 人 列表 。 
9.1.4 地 图 浏览 


显示 地 图 前 需要 对 地 图 进行 定位 ,IP 地 址 .地理 名 称 ( 即 城市 地 址 ) 和 经 纬度 是 三 
常见 的 地 图 定位 方法 。 当 用 户 使 用 计算 机 上 网 时 使 用 IP 地 址 对 地 图 进行 定位 是 一 种 比 
较 好 的 选择 ,这 种 方法 可 以 根据 IP 地 址 快速 识别 用 户 地 理 位 置 .但 这 种 方法 的 缺点 是 定 
位 精度 不 够 精确 ,而 且 不 能 够 移动 定位 。 在 野外 出 行 的 人 员 可 能 对 所 处 地 并 不 熟悉 ,快速 
熟悉 所 处 地 的 一 个 做 法 是 利用 GPS 和 手机 基站 检测 到 的 经 纬度 对 地 图 进行 定位 ,这 种 方 
法 的 优点 是 实时 和 便捷 ,但 缺点 是 比较 耗 电 。 如 果 用 户 已 知 某 地 的 城市 地 址 ,输入 该 地 的 
城市 地 址 对 地 图 进行 定位 是 比较 便捷 的 方法 。 这 种 根据 城市 地 址 对 地 图 进行 定位 的 好 处 
是 具有 较 好 的 用 户 体验 .用户 可 以 不 用 记 住 难以 记 住 的 经 纬度 值 , 只 需 知 道 城市 地 址 甚至 
只 需 知 道 地 址 关键 词 就 可 以 在 移动 中 快速 定位 地 图 。SL4A 提供 了 根据 地 址 定位 地 图 的 
接口 ,下面 是 接口 定义 。 


viewMap (String query) 


其 作用 是 根据 城市 地 址 对 地 图 进行 定位 :参数 query 表示 城市 地 址 ,城市 地 址 可 以 是 
完整 的 地 址 ,也 可 以 是 城市 地 址 的 关键 词 ,其 为 字符 串 数据 类 型 。 该 方法 会 调用 第 三 方 地 
图 应 用 对 城市 地 址 进行 地 图 定位 。 

例 9-2 是 地 图 浏览 实例 .该 实例 会 启动 第 三 方 地 图 应 用 对 城市 地 址 “北京 天 安 门 ” 自 
动 进行 地 图 定位 。 

【 例 9-2】 (代码 位 置 : \9\testViewMap. js) 

load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 

var droid= new Android(); 


var query= “北京 天 安 门 “; 


var ret= droid. viewMap (query) ; 

程序 运行 后 会 启动 地 图 应 用 并 把 地 图 定位 到 “北京 天 安 门 ”所 在 地 。 如 果 手 机 上 安装 
多 个 不 同 的 地 图 应 用 . 则 会 提供 用 户 选择 一 个 地 图 应 用 。 图 9-2 是 运行 结果 ,其 中 
图 9-2(a) 提 示 用 户 可 以 选用 “高 德 " 和 “腾讯 地 图 "地 图 应 用 ( 需 在 系统 中 先 安装 这 两 个 应 
用 ) .图 9-2(b) 是 高 德 应 用 定位 到 的 “北京 天 安 门 ” 地 图 。 
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选择 要 使 用 的 应 用 
EE QQ 
高 和 地 图 册 讯 地 图 
_] 下 次 以 认 过 择 此 项 , 不 再 提示 em 
(a) (b) 
图 9-2 地 图 定位 


9.1.5 HTML 浏览 


本 地 HTML 文件 可 以 使 用 文件 管理 器 .浏览 器 和 文字 编辑 器 等 应 用 打开 .不 同类 
型 的 应 用 打开 HTML 文件 时 .会 有 不 同 的 解析 方式 。 用 文件 管理 器 打开 HTML 文件 会 
显示 文件 的 大 小 和 创建 时 间 等 相关 信息 .用 文字 编辑 器 打开 HTML 文件 会 显示 HTML 
源 代码 ,用 浏览 器 打开 HTML 文件 会 显示 HTML 页 面 。 尽 管 浏览 本 地 HTML 文件 的 
方法 众多 ,但 SL4A 还 是 为 浏览 HTML 文件 提供 了 统一 的 方法 viewHTML ,方法 具体 定 
义 如 下 所 示 。 


viewHtml (String path) 


其 作用 是 打开 本 地 HTML 文件 .参数 path 表示 本 地 HTML 文件 ,可 以 是 文件 名 或 
带 有 路 径 的 文件 名 字符 串 。 方 法 被 调用 后 .系统 会 提示 用 户 选择 一 个 浏览 HTML 文件 
的 应 用 .之 后 会 使 用 该 应 用 打开 HTML 文件 。 


9.1.6 查询 任务 


用 户 在 使 用 Android 系统 过 程 中 会 经 常 碰 到 查询 任务 .例如 ,通过 手机 号 码 查找 联系 
人 ,通过 浏览 器 查找 指定 关键 字 相 关 信 息 . 通 过 美 团 网 查找 饭店 .这 些 都 是 查询 任务 的 典 
型 应 用 。SL4A 提供 了 search 方法 用 于 启动 查询 任务 .方法 如 下 所 示 。 


search (String query) 


其 作用 是 启动 一 个 搜索 活动 .参数 query 表示 搜索 活动 所 接受 的 查询 串 。 调 用 该 方 
法 后 ,系统 会 先 提 示 用 户 选 择 一 个 搜索 应 用 .之 后 启动 该 搜索 应 用 并 按 查 询 串 query 进行 
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92 应 用 管理 


9.2.1 启动 应 用 


Launcher 是 Android 系统 的 桌面 应 用 ,这 个 应 用 用 来 加 载 所 有 已 安装 的 应 用 列表 ， 
当 单 击 程序 列表 中 的 图 标 时 则 会 启动 和 这 个 图 标 对 应 的 一 个 应 用 ,或 者 说 ,用 户 从 
Launcher 应 用 中 启动 了 另 一 个 应 用 。 在 一 个 应 用 中 启动 另 一 个 应 用 是 比较 常见 的 情况 ， 
例如 ,在 电话 应 用 中 可 以 单 击 联系 人 列表 项 启动 短 消息 应 用 向 联系 人 发 送 短 消 息 。 

在 Java 中 ,通常 把 含有 main 函数 的 类 称 为 主 类 , 主 类 只 能 拥有 一 个 main 函数 ,这 个 
main 是 程序 执行 的 入 口 .Java 虚拟 机 规定 可 以 通过 主 类 启动 应 用 。Android 沿袭 了 Java 
的 做 法 ,应 用 程序 A 只 要 给 出 应 用 程序 B 的 主 类 名 就 可 以 启动 应 用 程序 B。 表 9-3 列 出 
了 常见 的 Android 内 置 应 用 程序 主 类 。 


表 9-3 Android 内 置 应 用 的 主 类 


























应 用 名 称 应 用 主 类 
音乐 播放 器 com. android. music. MusicBrowserActivity 
视频 播放 器 com. android. music. VideoBrowserActivity 
录音 机 com. android. music. MediaPlaybackActivity 
相机 com. android. camera. Camera 
浏览 器 com. android. browser. BrowserActivity 
闸 钟 com. android. alarmclock. AlarmClock 
日 历 com. android. calendar. LaunchActivity 
计算 器 com. android. calculator2. Calculator 





SL4A 提供 了 launch 接口 .通过 它 应 用 程序 可 以 启动 另 一 个 应 用 程序 ,该 接口 带 有 一 
个 参数 className., 该 参数 表示 主 类 名 .下 面 是 接口 launch 的 定义 格式 。 


launch (String className) 


例 9-3 是 通过 主 类 启动 计算 器 应 用 的 实例 .运行 结果 如 图 9-3 所 示 。 
【 例 9-3】 代码 位 置 : \9\testLaunchPackage. js) 

load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”):; 
var android= new Android(); 


myclass=“com. android. calculator2. Calculator”; 


android. launch (myclass); 
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9.2.2 停止 应 用 


包 是 Android 应 用 的 唯一 身份 标识 .不 论 应 用 的 名 称 如 何 改变 ,只 要 应 用 的 包 名 相 
同 ,Android 系统 就 认为 是 同一 个 应 用 。 如 果 两 个 应 用 的 包 名 相同 ,那么 就 认为 是 同一 个 
应 用 ,后 安装 的 应 用 会 替代 先前 安装 的 应 用 。 包 名 是 开发 者 为 Android 应 用 定义 的 名 字 ， 
尽管 包 名 可 由 开发 者 任意 预定 义 , 但 包 名 还 是 有 命名 规范 的 . 它 采 用 反 域 名 命名 规则 ,全 
部 使 用 小 写字 母 , 一 级 包 名 为 com, 二 级 包 名 为 xx( 可 以 是 公司 域名 或 者 个 人 姓名 ) ,三 级 
包 名 根据 应 用 进行 命名 。 例 如 “com. tencent. mobileqq" 表 示 腾 讯 公司 QQ 应 用 的 包 名 。 
表 9-4 是 Android 自 带 应 用 的 包 名 。 





图 9-3 启动 计算 器 


表 9-4 Android 自 带 应 用 包 名 






































应 用 包 包 名 应 用 包 包 名 

软件 包 访问 帮助 
com. android. defcontainer 信息 com. android. mms 

程序 
启动 器 com. android. launcher 媒体 储存 com. android. providers. media 
搜索 com. android. quicksearchbox 设置 com. android. setting 
通讯 录 com. android. contacks 拨号 器 储存 com. android. providers. telephony 
拨号 器 com. android. phone 账户 与 同步 设置 | com. android. providers. telephony 
浏览 器 com. android. browser 发 送 邮 件 com. android. email 
音乐 com. android. music 录音 机 com. android. soundrecorder 
ed dl re ee vpn Android 键盘 com. android. inputmethod. latin 
相机 com. android. gallery 状态 栏 com. android. systemui 





SL4A 提供 方法 forceStopPackage 用 来 停止 应 用 . 它 的 定义 格式 如 下 所 示 。 


forceStopPackage (packageName) 


packageName 是 应 用 的 包 名 .其 为 字符 串 数据 类 型 。 例 9-4 是 停止 应 用 的 实例 . 例 中 
关闭 了 包 名 为 com. android. music 的 应 用 .运行 应 用 前 先 运行 DDMS 程序 ,图 9-4 是 运行 
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应 用 前 的 DDMS 界面 .注意 观察 图 中 画 横 线 包 名 com. android. music 在 应 用 运行 前 后 的 
变化 ,会 发 现 运行 应 用 后 包 名 消失 ,这 是 因为 包 对 应 的 应 用 被 停止 了 。 


























Name 
comandroidjJauncher 160 8604 
android.process.acore 201 8606 
android.process.media 225 8607 
com.android.mms 242 8608 
com.android.deskclock 262 8605 
com.android.email 277 8609 
com.android.quicksearchbox 288 8610 
Somandroidmusic 3o0 8611 
com.android.protips 310 8612 








图 9-4 停止 内 带 应 用 前 的 DDMS 
【 例 9-4】 (代码 位 置 : \9\testStopPackages. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var mypackage= “com. android. music”; 


var ret= droid. forceStopPackage (mypackage) ; 


9.2.3 应 用 的 包 列表 


SL4A 提供 方法 getRunningPackages 用 来 返回 系统 当前 正在 运行 的 应 用 和 服务 的 
包 列表 ,列表 用 数组 表示 ,每 个 数组 元 素 代 表 一 个 包 . 方 法 的 定义 如 下 所 示 . 


getRunningPackages () 


例 9-5 是 getRunningPackages 方法 示例 ,程序 以 控制 台 方 式 运行 ,图 9-5 是 程序 运行 
结果 , 它 列 出 了 系统 当前 运行 的 应 用 和 服务 的 包 名 ,每 行 表示 一 个 包 名 


苦 ll 自 8:12 
com.android.providers.drm 
com.android.systemui 
com.android.packageinstaller 
com.android.providers.telephony 
com.android.music 
[uo 
jp.co.omronsoft .openwnn 
com.android .email 
com.android.providers.userdictionary 
com.android.deskclock 
com.android,.providers.settings 
com.android.mms 
com.android.providers.media 
com.android.providers.downloads 
com.googlecode.android_scripting 
com. googlecode.rhinoforandroid 


图 9-5 应 用 程序 的 包 列 表 
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【 例 9-5】 〈 代 码 位 置 : \9\testRunPackages. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js“) ; 
var droid= new Android(); 
var ret= droid. getRunningPackages () ; 
for(var i=0,a;a=ret[i++];){ 
print (a); 


让 


9.2.4 应 用 的 类 列表 


Android 绝 大 多 数 应 用 是 使 用 Java 语言 来 开发 的 .使 用 Java 便 意味 着 使 用 了 面向 对 
象 思想 。 面 向 对 象 思想 使 用 对 象 描述 系统 功能 特性 ,使 用 类 抽象 出 对 象 的 结构 和 行为 。 
可 以 把 一 台 实 实在 在 的 电视 机 理解 为 对 象 .而 电视 机 设计 和 原理 图 理解 为 类 , 它 对 电视 机 
的 外 观 特性 和 工作 原理 进行 了 描述 。 类 是 对 象 的 抽象 数据 结构 , 它 由 属性 和 方法 组 成 , 属 
性 代表 对 象 的 静态 状态 ,方法 代表 对 象 的 动态 行为 。 对 象 由 类 创建 ,对 象 和 对 象 交 互 构造 
出 了 整个 系统 。 类 有 自己 的 命名 法 和 英文 缩写 规则 。 驼 峰 (Camel) 命 名 法 .下 画 线 命名 
法 和 匈牙利 命名 法 是 常见 的 类 命名 法 。Android 中 的 类 通常 采用 驼峰 命名 法 。 驼峰 法 指 
混合 使 用 大 小 写字 母 来 为 变量 .类 和 函数 等 命名 的 规则 。 了 驼峰 法 又 分 为 小 驼峰 和 大 驼峰 
法 。 小 驼峰 法 除 第 一 个 单词 之 外 .其 他 单词 首 字母 大 写 ,常用 在 变量 命名 , 辟 如 变量 
myStudentrNo。 大 驼峰 法 把 第 一 个 单词 的 首 字 母 也 大 写 了 .常用 于 类 名 、 函 数 名 属性 和 
命名 空间 ,例如 类 名 UserInfo。 类 名 尽量 避免 缩写 .除非 该 缩写 是 众所周知 的 , 例如 
HTML 和 URL ,如 果 类 名 称 中 包含 单词 缩写 . 则 单词 缩写 的 每 个 字母 均 应 大 写 。 驼 峰 法 
的 标识 符 看 上 去 就 像 骆驼 峰 一 样 此 起 彼 伏 ,故此 得 名 。 下 划 线 命名 法 中 的 单词 与 单词 间 
用 下 画 线 作 间隔 。 匈 牙 利 命名 法 被 广泛 应 用 于 微软 的 VC 等 编程 语言 中 。 

SL4A 提供 方法 getLaunchableApplications 用 来 返回 当前 应 用 类 列表 .列表 用 数组 
表示 ,每 个 数组 元 素 代表 一 个 类 .方法 定义 如 下 所 示 。 


getLaunchableApplications () 


例 9-6 是 查询 可 被 启动 的 应 用 主 类 .图 9-6 是 运行 结果 .图 中 result 以 下 内 容 是 可 启 
动 的 应 用 和 应 用 主 类 ,符号 “一 二 ”左边 是 应 用 名 称 .右边 是 应 用 主 类 名 。 
【 例 9-6】 〈 代 码 位 置 : \9\testLaunchableApps. js)1 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android= new Android(); 
var myObject= android. getLaunchableApplications(); 
Var s=""; 
for (var property in myObject) { 
s=st”\n “+property+”: “+myObject[property] ; 
} 


print (s); 
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上 午 11:05 





图 9-6 launch 的 应 用 主 类 


93 了 唤 醒 锁 


9.3.1 什么 是 唤醒 锁 


智能 手机 的 一 个 特点 是 外 形 较 小 .这 大 大 地 限制 了 可 容纳 的 电池 尺寸 。 要 求 智能 手 
机 具备 超 强 的 计算 能 力 ,同时 又 要 求 其 具备 超 长 的 电池 续航 能 力 是 难以 实现 的 。 没 电 的 
智能 手机 和 一 块 砖 块 是 没什么 差别 的 。Android 系统 为 了 省 电 以 及 减少 CPU 消耗 ,在 锁 
屏 一 段 时 间 后 会 使 系统 进入 睡眠 状态 ,这 时 ,Android 系统 会 保持 在 一 个 相对 较 低 的 功 耗 
状态 (屏幕 关闭 和 CPU 进入 深度 节能 状态 等 )。 这 就 是 智能 手机 充满 一 次 电 便 能 持续 使 
用 和 待机 的 原因 。 当 智能 手机 处 于 睡眠 状态 时 .类似 微 信和 QQ 之 类 的 软件 会 有 新 消息 
到 达 , 新 消息 到 来 意味 着 有 网 络 请 求 ,而 网 络 请 求 需要 CPU 响应 和 处 理 ,如 何在 锁 屏 状 
态 乃 至 系统 进入 睡眠 状态 后 .仍然 保持 系统 的 网 络 状 态 以 及 通过 程序 唤醒 智能 手机 呢 ? 
出 于 此 原因 ,Android 系统 的 开发 商 Google 公司 在 其 PowerManager API 中 增加 了 唤醒 
锁 , 应 用 程序 通过 唤醒 锁 可 以 阻止 设备 进入 睡眠 状态 。 只 要 Android 系统 上 有 活动 的 唤 
醒 锁 ,设备 便 无 法 进入 挂 起 模式 ,除非 释放 唤醒 锁 。 使 用 唤醒 锁 时 .应 用 必须 将 其 正确 释 
放 , 因 为 未 释放 的 唤醒 锁 无 法 进入 默认 的 节能 状态 .从 而 很 快 会 使 设备 电源 耗 尽 。 看 视 
频 、 昕 音乐 .使 用 GPS 以 及 玩 游戏 时 可 以 使 用 唤醒 锁 阻 止 应 用 所 需 的 设备 部 件 ( 屏 幕 、 键 
盘 和 CPU 等 ) 进 入 睡眠 状态 不 能 继续 为 用 户 服务 .同时 .其 他 设备 部 件 可 以 继续 睡眠 进 
入 节能 状态 。SL4A 提供 了 4 种 类 型 的 唤醒 锁 , 具 体 如 表 9-5 所 示 。 


表 9-5 唤醒 锁 类 型 














唤醒 锁 类 型 设备 状态 
a bright wake lock CPU 开启 ;屏幕 变 亮 ; 键 盘 关闭 
a dim wake lock CPU 开启 ;屏幕 暗淡 ;键盘 关闭 
a full wake lock CPU 开启 ;屏幕 变 亮 ;键盘 变 亮 
a partial wake lock CPU 开启 ;屏幕 关闭 ;键盘 关闭 
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下 面 是 SL4A 提供 的 唤醒 锁 相 关 函 数 , 其 用 来 申请 和 释放 唤醒 锁 ,. 具 体 如 下 所 示 。 


wakeLockAcquireBright () 


其 功能 是 向 系统 申请 bright 唤醒 锁 ,系统 接受 锁 申请 后 会 阻止 CPU 和 屏幕 进入 睡 
眠 状态 ,继续 让 CPU 开启 和 屏幕 变 亮 。 


wakeLockAcquireDim() 


其 功能 是 向 系统 申请 dim 唤醒 锁 , 系统 接受 锁 申请 后 会 阻止 CPU 和 屏幕 进入 睡眠 
状态 ,继续 让 CPU 开启 和 屏幕 变 暗淡 。 


wakeLockAcaquireFull() 


其 功能 是 向 系统 申请 full 唤醒 锁 , 系统 接受 锁 申 请 后 会 阻止 CPU 键盘 和 屏幕 进入 
睡眠 状态 ,继续 让 CPU 开启 、 屏 幕 变 亮 和 键盘 变 亮 。 


wakeLockAcquirePartial() 


其 功能 是 向 系统 申请 partial 唤醒 锁 ,系统 接受 锁 申请 后 会 阻止 CPU 进入 睡眠 状态 ， 
继续 让 CPU 开启 。 


wakeLockRelease() 


释放 唤醒 锁 。 
9.3.2 唤醒 锁 申请 和 睡眠 检测 


例 9-7 是 唤醒 锁 例 子 .程序 可 以 申请 a bright wake lock .a dim wake lock .a full wake 
lock 和 a partial wake lock” 了 唤醒 锁 , 程 序 由 文件 WakeLock. xml 和 WakeLock. php 组 成 ， 
前 者 负责 设计 UI, 后 者 负责 申请 唤醒 锁 。 

【 例 9-7】 〈 代 码 位 置 : \9\WakeLock) 

文件 WakeLock. xml: 


《<?xml version= "1.0” encoding= “utf- 8”?> 

<LinearLayout xmlns:android= “http://schemas.android. com/apk/res/android” 
android:id=“@+id/background” 
android:orientation= “vertical” android:layout width= “match parent” 
android:layout_height= “match_parent” android:background=“#ff000000”> 


<Button android:id=“@+id/buttonl” 


android:layout width= “match parent” 


android:layout height=“wrap_content” 
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文件 WakeLock.js: 
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if (id==“buttonl” ) ret= droid. wakeLockAcquireBright (); 


if (id==“button2” ) 


ret= droid. wakeLockAcquireDim(); 


if (id==“button3” ) 
ret= droid. wakeLockAcquireFul] (); 


if (id==“button4” ) 
ret= droid. wakeLockAcquirePartial (); 


function file_get_contents (fileName) { 
var file=new java. io.File (fileName); 
var reader= new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“"; 
// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 
while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close (); 
return fileString; 


} 


运行 程序 前 , 先 在 Android 系统 “设置 "“ 锁 屏 和 密码 "处 设置 自动 锁 屏 时 间 , 本 书 自 
动 锁 屏 时 间 为 30s。 程 序 运行 前 . 先 对 Android 系统 进行 任意 操作 ,然后 等 待 30s( 不 要 进 
本 行 单 击 屏幕 和 按 下 按钮 等 操作 ) ,最 后 会 发 现 


状态 ,直至 再 次 按 下 电源 按钮 或 电话 来 电 等 
an | 事件 的 出 现 才 从 睡眠 状态 转换 到 运行 状态 ， 


屏幕 再 次 点 亮 。 运 行程 序 后 , 单 击 按钮 “唤醒 
Dim”, 继 续 等 待 30s ,会 发 现 屏幕 并 不 会 黑屏 


而 是 变 瞳 淡 ,说 明 系 统 已 经 申请 了 唤醒 锁 阻 
人 
屏幕 .CPU 和 键盘 进入 睡眠 状态 。 图 9-7 是 


图 9-7 ”了 唤醒 锁 应 用 运行 结果 运行 结果 。 
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94 系统 设置 


9.4.1 声音 和 震动 设置 


Android 系统 可 以 分 别 自 定义 手机 铃声 、 通 知 栏 (Notification) 提 示 音 .闹钟 语音、 媒 
体 和 蓝牙 等 声音 的 音量 。Android 手机 可 以 将 声音 模式 设置 成 声音 ,静音 和 震动 模式 。 
SL4A 提供 了 和 铃声 .通知 栏 和 媒体 相关 的 声音 函数 . 主要 用 于 打开 /关闭 声音 模式 和 设 
置 音量 等 ,具体 如 下 所 示 。 


checkRingerSilentMode() 
检测 铃声 是 否 为 静音 模式 ,如 返回 值 为 true 则 为 静音 模式 。 
toggleRingerSilentMode (Boolean enabled) 


打开 或 关闭 铃声 静音 模式 .如 参数 enabled 为 true 则 打开 静音 模式 ,否则 关闭 静音 


getMaxRingerVolume () 

获取 铃声 最 大 音 音 量 .默认 值 为 15 。 

getRingerVolume () 

获取 当前 铃声 音量 ,返回 值 为 整数 , 值 越 小 表示 音量 越 小 . 值 越 大 表示 音量 越 大 。 
setRingerVolume (Integer volume) 

设置 铃声 音量 ,参数 volume 表示 音量 .整数 数据 类 型 .0 表示 静音 。 
getMaxMediaVolum() 

获取 媒体 最 大 音量 。 

getMediaVolume () 

获取 当前 媒体 音量 .返回 值 为 整数 。 

setMediaVolume (Integer volume) 

设置 当前 媒体 音量 .参数 volume 表示 音量 .整数 数据 类 型 .0 表示 静音 。 


toggleVibrateMode (Boolean enabled, Boolean ringer) 
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打开 或 关闭 震动 模式 ; 如 果 参 数 enabled 为 true 则 表示 设置 为 震动 模式 ;如 果 参 数 
ringer 值 为 true 则 设置 铃声 的 震动 模式 ;如 果 参 数 ringer 为 false 表示 设置 通知 
(CNotification) 的 震动 模式 。 


getVibrateMode (Boolean ringer) 


检测 是 否 为 震动 模式 ,如果 参数 ringer 为 true 则 表示 检测 铃声 的 震动 模式 ,如 果 参 
数 ringer 为 false 则 表示 检测 通知 (Notification) 的 震动 模式 。 如 果 返 回 值 为 true 则 表示 


vibrate(Integer duration[optional，default 300]: duration in milliseconds) 


用 于 设置 震动 ,参数 duration 表示 震动 时 间 ,单位 是 ms, 默认 是 300ms, 该 参数 是 可 
选 的 。 

例 9-8 是 铃声 测试 程序 .程序 可 以 实现 设置 静音 模式 、 获 取 最 大 音量 .获取 当前 音量 
和 设置 音量 等 功能 。 

【 例 9-8】〗】 〈 代 码 位 置 : \9\Ringer. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
droid. dialogCreateAlert (“铃声 测试 ^); 
var items=new Array(); 
var ret=null; 
items[0]= "开始 震动 ; 
items[1]= "设置 铃声 静音 模式 ; 
items[2]= "获取 铃声 最 大 音量 ; 
items[3]= "获取 当前 铃声 音量 ; 
items[4]= "设置 铃声 音量 为 3 ; 
items[5]= "退出 应 用 ; 
droid. dialogSetItems (items) ; 
droid. dialogShow() ; 
var response= droid. dialogGetResponse() ; 
Switch (response. item ) 
f 
case 0: 
ret= droid. vibrate(1000) ; 
break; 
case 1: 
ret= droid. setRingerVolume (0); 
break; 
case 2: 
ret= droid. getMaxRingerVolume () ; 
var maxvol= ret; 


188 


第 9 富 通用 和 在座 .应 用 管理 乏 的 员 芽 


droid. dialogCreateAlert (“铃声 最 大 音量 “, “最 大 值 : “+ maxvol) ; 
droid. dialogShow() ; 
droid. dialogGetResponse(); 
break; 
case 3: 
ret= droid. getRingerVolume () ; 
var volume= ret; 
droid. dialogCreateAlert (“当前 铃声 音量 ,“ 当 前 值 : “+ volume) ; 
droid. dialogShow() ; 
droid. dialogGetResponse(); 
break; 
case 4: 
ret= droid. setRingerVolume (3) ; 
break; 
default: 
break; 


} 


运行 程序 .用 户 有 6 个 选择 项 .分 别 是 “开始 震动 “铃声 静音 设置 “铃声 最 大 音量 ” 
“铃声 当前 音量 “设置 铃声 音量 "和 “退出 应 用 ”*"。 如 果 单 击 “ 开 始 震 动 ”按钮 则 手机 会 震 
动 。 如 果 单 击 “ 铃 声 静 音 设置 "按钮 则 铃声 音量 为 零 。 如 果 单 击 “ 铃 声 最 大 音量 "按钮 则 显 
示 最 大 音量 值 。 如 果 单 击 “ 铃 声 当 前 音量 "按钮 则 显示 当前 铃声 音量 。 如 果 单 击 “ 设 置 铃 
声音 量 ” 按 钮 则 设置 当前 系统 的 铃声 为 3。 如 果 单 击 退 出 应 用 ”按钮 则 退出 程序 。 图 9-8 
是 应 用 运行 结果 ,其 中 .图 9-8(a) 是 主 界面 ,图 9-8(b) 是 单 击 “铃声 当前 音量 ”按钮 后 显示 
的 当前 铃声 音量 值 5。 


9.4.2 屏幕 设置 


用 户 在 指定 时 间 内 可 能 没有 任何 操作 .为 了 节省 电量 .系统 就 会 自动 锁 屏 关 闭 掉 屏 幕 
背景 灯 。 有 些 应 用 可 以 感应 外 界 光线 :根据 外 界 光线 亮度 智能 设置 屏幕 背光 亮度 .以 此 达 
到 省 电 或 保护 眼睛 等 目的 。 系 统 闹 钟 到 来 的 时 候 .需要 保持 亮 屏 .之 后 又 需要 保持 煌 屏 。 
SL4A 可 以 让 应 用 拥有 检测 屏幕 锁 屏 状态 、 指 定 超时 自动 锁 屏 时 间 和 设置 获取 屏幕 亮度 
等 功能 .下 面 是 SL4A 屏幕 设置 相关 函数 。 


checkScreenOn () 


检测 屏幕 是 否 锁 屏 .返回 值 为 true 表明 屏幕 未 锁 屏 ,否则 表明 屏幕 已 锁 屏 。 


setScreenTimeout (Integer value) 


设置 屏幕 超时 锁 屏 时 间 , 以 s 为 单位 .其 返回 值 是 之 前 设置 的 锁 屏 时 间 。 
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getScreenTimeout () 


获取 当前 锁 屏 时 间 . 以 s 为 单位 。 


setScreenBrightness (Integer value) 


设置 屏幕 背光 亮度 ,参数 value 表示 亮度 值 , 其 值 范围 为 0 一 255, 值 越 小 屏幕 越 暗 , 值 
越 大 屏幕 越 亮 。 


getScreenBrightness() 


获取 当前 屏幕 亮度 ,返回 值 范 围 为 0 一 255, 返 回 值 越 小 表明 屏幕 越 暗 . 值 越 大 表明 屏 
幕 越 亮 。 


时 


开始 震动 


设置 铃声 静音 模式 
当前 铃声 音量 
当前 值 :5 


获取 铃声 最 大 音量 


获取 当前 铃声 音量 


设置 铃声 音量 为 3 


退出 应 用 





只 ee 中 让 


上 si 
en 
- 
3 
- 
二 
- 
态 
地 
中 
二 
C3 
夺 
他 
中 
- 


(a) 主 界 (b) 当前 铃声 音量 


图 9-8 铃声 测试 


9.4.3 飞行 模式 设置 


飞行 模式 又 叫 航空 模式 或 航班 模式 ,开启 飞行 模式 后 .智能 手机 的 GSM/GPRS/4G 
等 电话 通信 模块 将 被 停止 使 用 .手机 不 会 主动 向 基站 发 送 寻 呼 信号 . 即 不 试图 联系 基站 、 
但 一 般 可 拨打 紧急 电话 。 之 所 以 设置 飞行 模式 ,主要 是 因为 手机 寻 呼 信号 会 干扰 飞机 上 
的 电子 设备 正常 工作 。 尽 管 飞行 模式 会 关闭 手机 信号 的 有 关 功 能 .但 手机 可 以 继续 使 用 
其 他 功能 ,如 阅读 小 说 、 看 视频 . 听 音 乐 和 玩 游戏 等 。 飞 行 模式 还 拥有 其 他 好 处 ,如 减少 对 
身体 的 辐射 和 节省 电量 等 。 下 面 是 SL4A 飞行 模式 相关 函数 。 


checkAirplaneMode (O) 
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检测 系统 是 否 处 于 飞行 模式 ,如果 返回 的 值 是 true 则 表示 系统 处 在 飞行 模式 。 


toggleAirplaneMode (Boolean enabled [optional]) 


打开 或 关闭 系统 飞行 模式 ,参数 enabled 表示 打开 或 关闭 飞行 模式 ,其 为 布尔 数据 类 
型 ,可 选 , 如 果 为 true 则 表示 打开 飞行 模式 .否则 关闭 飞行 模式 。 
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通信 与 传感器 


10.1 电话 通信 


10.1.1 手机 基本 概念 


1G( 第 一 代 ) 移 动 通信 技术 是 指使 用 模拟 技术 且 仅 限 语音 的 蜂窝 电话 标准 。2G( 第 二 
代 ) 手 机 通信 技术 以 数字 语音 传输 技术 为 核心 。GSM (Global System for Mobile 
Communication) 中 文 名 为 全 球 移动 通信 系统 . 它 属于 第 二 代 蜂 窝 移 动 通信 技术 , 它 是 当 
前 应 用 最 为 广泛 的 移动 电话 标准 。2. 5G 是 一 种 介 于 2G 和 3G 之 间 的 无 线 技术 ,蓝牙 
(Bluetooth) 等 属 2. 5G 技术 。3G( 第 三 代 ) 是 第 三 代 移 动 通信 技术 .是 指 支持 高 速 数据 传 
输 的 蜂窝 移动 通信 技术 .CDMA2000、WCDMA 和 TD-SCDMA 等 属 3G 技术 .3G 下 行 速 
度 峰值 理论 可 达 3. 6Mb/s( 一 说 2. 8Mb/s) ,上行 速度 峰值 也 可 达 384Kb/s。4G( 第 4 代 ) 
是 第 四 代 移 动 通信 技术 的 简称 . 它 是 支持 高 速 数据 率 连 接 的 理想 模式 .对 于 大 范围 高 速 移 
动用 户 (230km/h), 数据 率 可 达 2Mb/s; 对 于 中 速 移动 用 户 (60km/h) 数 据 率 可 达 
20Mbit/s; 对 于 低速 用 户 (室内 或 步行 ) 数 据 率 可 达 100Mbit/s。 

IMEI(International Mobile Equipment Identity ,国际 移 动 设 备 识 别 码 ) 俗 称 " 串 号 ”。 
IMEI 在 全 世界 是 唯一 的 . 它 是 手机 设备 的 唯一 识别 码 , 每 部 手机 在 生产 时 就 被 赋予 一 个 
IMEI 码 。IMEI 码 由 GSM(Global System for Mobile Commmunications .全球 移 动 通信 协 
会 ) 统 一 分 配 。IMEI 由 15 位 数字 组 成 .前 6 位 数 是 “型 号 核准 号 码 (Type Approval 
Code,TAC)”, 一 般 代 表 机 型 ;接着 的 两 位 数 是 “最 后 装配 号 (Final Assembly Code， 
FAC)”, 一 般 代表 产地 ;之 后 的 6 位 数 (SNR) 是 “ 串 号 ” .一般 代 表 生 产 顺 序号 ;最 后 一 位 
数 (SP) 通 常 是 “0”. 其 为 检验 码 . 目 前 暂 备用 。 在 刷机 时 .手机 IMEI 码 可 能 会 丢失 ,通过 
“MTK 大 师 ” 和 “移动 朴 玻 "等 软件 可 刷 写 恢复 手机 IMEI 码 。 手 机 IMEI 码 可 以 在 包装 
盒 . 机 身 和 保修 卡 上 查询 .也 可 以 在 手机 电话 软件 中 输入 “ * #06# ”查询 。 如 果 手 机 丢 
失 , 通 过 运营 商 将 该 手机 的 IMEI 列 入 黑 名 单 .丢失 的 手机 将 被 禁止 使 用 。 目 前 GSM 和 
WCDMA 手机 终端 需要 使 用 IMEI 号 码 。MEID(Mobile Equipment IDentifier) 是 全 球 唯 
一 的 移动 终端 标识 号 .标识 号 会 被 烧 入 终端 里 .并 且 不 能 被 修改 .可 用 来 对 移动 式 设备 进 
行 身份 识别 和 跟踪 . MEID 主要 分 配给 CDMA 制式 的 手机 。MEID 号 码 由 
Telecommunications Industry Association(TIA) 分 配 管理 。MEID 号 码 的 查看 ,目前 没 
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有 一 个 通用 的 方法 ,由 各 手机 制造 商 自 己 设置 。MEID 由 14 个 十 六 进 制 数字 组 成 ,其 格 
式 为 “RRXXXXXXZZZZZZCD” ,RR 也 叫 区 域 码 , 取 值 为 A0 一 FF;XXXXXX 由 制造 商号 
码 管理 机 构 统 一 分 配 , 取 值 范围 为 000000 一 FFFFFF;ZZZZZZ 是 厂商 分 配给 每 台 终 端的 
流水 号 , 取 值 范围 为 000000 一 FFFFFF。CD 是 校 验 码 。CD 不 参与 传输 ,或 者 说 最 终 获 
取 到 的 MEID 不 包括 CD 校 验 码 。 

IMSI(International Mobile Subscriber Identification Number) 中 文 翻译 为 国际 移动 
用 户 识别 码 . 是 区 别 移动 用 户 的 标志 .储存 在 SIM 卡 中 .可 用 于 区 别 移动 用 户 的 有 效 信 
息 。IMSI 共 有 15 位 ,其 结构 是 : MCC 十 MNC 十 MSIN。MCCCMobile Country Code) 中 
文 翻 译 为 移动 国家 码 ,MCC 的 资源 由 国际 电 联 (ITU) 统 一 分 配 和 管理 ,唯一 识别 移动 用 
户 所 属 的 国家 , 共 三 位 ,中 国 为 460; MNC(Mobile Network Code) 中 文 翻译 为 移动 网 络 
码 , 共 两 位 ,中 国 移动 TD 系统 使 用 00, 中 国联 通 GSM 系统 使 用 01, 中 国 移动 GSM 系统 
使 用 02, 中 电信 CDMA 系统 使 用 03。MSIN (Mobile Subscriber Identification 
Number) 是 移动 用 户 识别 号 码 , 共 有 10 位 ,用 来 标识 一 个 移动 网 络 中 的 移动 用 户 身 份 。 
一 个 典型 的 IMSI 号 码 为 460030912121001。 MSISDN (Mobile Subscriber International 
ISDN/PSTN number) 是 主 则 用 户 呼 则 GSM PLMN 中 的 一 个 移动 用 户 所 需 拨 的 号 码 , 它 
由 CC 十 NDC 十 SN 组 成 。CC(Country Code) 是 国家 码 , 例 如 .中 国 的 国家 码 为 86。 
NDCCNational Destination Code) 是 国内 接 入 号 .如 中 国 的 NDC 目前 有 139、138、 
137、136 和 135 等 。SN(Subscriber Number) 是 客户 号 码 , 在 中 国 , 该 码 长 度 为 8。 
NDC 十 SN 就 是 通常 所 说 的 手机 号 ,例如 .139XXXXXXXX。IMSI 和 MSISDN 的 作 
用 是 相同 的 .它们 都 是 用 来 识别 移动 用 户 的 ,不 同 的 是 , MSISDN 用 手机 号 识别 移动 
用 户 ,IMSI 从 物理 上 识别 移动 用 户 .说 白 了 .移动 网 络 运 营 商 使 用 IMSI 识别 移动 用 
户 , 而 普通 人 是 使 用 MSISDN 来 识别 移动 用 户 。 

SIM 卡 是 Subscriber Identity Module 的 缩写 ,也 称 为 用 户 身份 识别 卡 或 智能 卡 。 它 
是 一 种 带 微 处 理 器 的 封装 在 塑料 中 的 智能 IC 卡 。 它 包含 用 户 识别 信息 、 辅 助 业务 信息 、 
短 消息 和 用 户 电话 筹 等 数据 。 在 GSM 系统 中 , 移动 终端 出 厂 后 是 不 能 直接 使 用 的 . 用 
户 必 须 在 网 络 运营 部 门 注册 一 张 SIM 卡 方 可 电话 通信 。 


10.1.2 电话 API 


手机 API 提供 有 拨打 电话 以 及 查询 移动 网 络 、 基 站 移动 设备 和 SIM 卡 信息 等 功能 。 
开发 人 员 可 以 借助 手机 API 轻易 地 实现 手机 定位 和 手机 通话 监控 等 功能 。 


checkNetworkRoaming () 


其 作用 是 检测 移动 设备 在 GSM 网 络 中 是 否 处 于 漫游 状态 。 它 会 返回 一 个 布尔 
值 ,true 值 表 示 处 于 漫游 状态 ,false 值 表 示 处 于 非 漫 游 状态 。 该 方法 需要 物理 设备 
支持 。 
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getCellLocation() 


其 作用 是 获取 当前 移动 终端 的 地 理 位 置 。 它 的 返回 值 是 对 象 ,对 象 包 括 cid 和 
lac 两 个 属性 ,cid 表示 基站 编号 .lac 表示 位 置 区 域 码 。 这 两 个 属性 值 可 以 确定 移动 
终端 的 地 理 位 置 ,例如 ,cid 值 为 60541 和 lac 值 为 14608 表示 中 国 福建 省 厦门 市 思 
明 区 中 华 路 .可 以 在 基站 查询 网 站 http://www. cellid. cn 验证 此 值 。 该 方法 需要 物 
理 设备 支持 。 


getDeviceld() 


返回 当前 移动 终端 的 唯一 标识 ,例如 .GSM 网 络 返 回 IMEI 码 .CDMA 网 络 返 回 
MEID 码 。 当 移动 终端 的 标识 不 可 获得 时 .返回 null。 该 函数 需要 在 真实 设备 下 运行 才 
有 效 ,如 果 在 模拟 器 下 运行 将 返回 15 个 0。 


getDeviceSoftwareVersion() 


返回 移动 终端 的 软件 版 本 .例如 ,GSM 手机 的 IMEI/SV 码 。 如 果 软 件 版 本 不 可 获 
得 , 则 返回 null。 该 函数 需要 在 真实 设备 下 运行 才 有 效 。 


getLinelNumber () 
在 一 行 中 返回 手机 号 码 , 例 如 ,返回 GSM 的 MSISDN 号 。 如 果 获 取 不 到 则 返回 null。 


getNeighboringCellInfo() 


其 作用 是 返回 当前 移动 终端 附近 基站 信息 。 其 返回 值 是 对 象 数 组 结构 .每 个 对 象 包 
括 cid 和 rssi 两 个 属性 .cid 表示 基站 编号 ,rssi 表示 移动 终端 到 基站 的 信号 强度 ,此 值 越 
大 表示 信和 号 越 强 。 


getNetworkOperator (0) 


返回 移动 终端 注册 的 网 络 运营 商 数字 编号 .该 数值 是 由 移动 国家 码 十 移动 网 络 码 
(MCC 十 MNC) 构 成 .该 值 长 度 为 5. 前 三 位 是 MCC. 后 两 位 是 MNC。 例如 .46000 和 
46002 表示 中 国 移动 .46001 表示 中 国联 通 .46003 表示 中 国电 信 。 


getNetworkOperatorName () 


返回 移动 终端 当前 注册 网 络 运 营 商 的 字母 名 称 .例如 .如 果 手 机 注册 的 是 中 国 移动 
GSM 网 则 返回 “中 国 移动 ”。 


getNetworkType () 
返回 移动 终端 当前 使 用 的 无 线 技术 (网 络 类 型 )。 如 果 移动 终端 接 入 的 是 中 国 移动 
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GSM 移 , 则 返回 字符 串 "edge"。 如 不 能 识别 或 没有 网 络 则 返回 "unknown"。 


getPhoneType () 


返回 移动 终端 的 类 型 。 如 果 终 端 设备 是 GSM 手机 将 返回 字符 串 "gsm"。 


getSimCountryIso() 


返回 符合 ISO 标注 的 国家 码 .等同 于 SIM 卡 提 供 商 的 国家 码 ,中国 国家 码 是 cn。 


getSimOperator() 


返回 SIM 卡 的 MCC 十 MNC 组 合 .组 合 由 SIM 提供 商 的 移动 国家 码 和 移动 网 络 码 
组 合 ,组 合 是 一 个 5 或 6 位 的 数字 。 


getSim0peratorName () 


返回 SIM 卡 的 服务 运营 商 的 名 称 , 中 国 移动 的 名 称 是 CMCC, 中 国联 通 的 是 
ChinaUnicom, 中 国电 信 的 是 ChinaNet。 


getSimSerialNumber () 


返回 SIM 卡 的 序列 号 ,如 果 无 法 获得 则 返回 null。 该 序列 号 是 20 位 数码 。 前 面 
6 位 网 络 运营 商 的 代号 ,898600 是 中 国 移动 的 代号 ;898601 是 中 国联 通 的 代号 ;898603 是 
中 国电 信 的 代号 ;第 7 位 是 业务 接 入 号 ,5、6、7、8、9 分 别 表 示 135、136、137、138 和 139 手 
机 号 ;第 8 位 是 SIM 卡 的 功能 位 ,一 般 为 0, 现在 的 预付 费 SIM 卡 为 1; 第 9.10 位 是 各 省 
的 编码 ;01 北京 ,02 天 津 ,03 河北 .04 山西 .05 内 蒙古 ,06 辽宁 ,07 吉林 .08 黑龙 江 ,09 上 
海 ,10 江苏 ,11 浙江 .12 安徽 .13 福建 ,14 江西 ,15 山东 ,16 河南 ,17 湖北 .18 湖南 .19 广 
东 ,20 广西 .21 海南 .22 四 川 ,23 贵州 .24 云南 .25 西藏 .26 陕西 ,27 甘肃 ,28 青海 ,29 宁 
夏 ,30 新 疆 .31 重庆 .第 11、12 位 是 年 号 ;第 13 位 是 供应 商 代码 ;第 14 一 19 位 则 是 用 户 识 
别 码 ; 第 20 位 是 校 验 位 。 


getSimState () 


返回 SIM 卡 状态 ,SIM 可 分 为 “无 卡 "“ 未 知 "“ 需 要 网 络 PIN 解锁 ”需要 PIN 解 
锁 ” “需要 PUK 解锁 "和 “良好 ”状态 。 值 *ready” 表 示 良 好 状态 .“absent” 表 示 无 卡 状态 ， 
“uknown” 表 示 未 知 状态 。 


getSubscriberId() 


返回 用 户 唯 一 标识 .例如 .:GSM 网 络 的 1MSI 编号 。 如 果 不 可 获得 则 返回 null。 


getVoiceMailAlphaTag() 
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获取 语音 信箱 号 码 关联 的 字母 标识 ,中国 移动 GSM 号 码 返 回 的 字母 标识 是 “语音 
信箱 ”。 

phoneCall (String uri) 


通过 uri 调用 一 个 联系 人 或 电话 号 码 , 例 如 ,phoneCall("tel:10086") 表 示 向 10086 拨 
打 电 话 。 


phoneCallNumber (String phonenumber) 


拨打 一 个 电话 ,参数 phonenumber 表示 电话 号 码 。 执 行 该 方法 会 触发 电话 软件 直接 
拨打 电话 。 


phoneDial (sring uri) 
通过 uri 调用 一 个 联系 人 或 拨号 。 
phoneDialNumber (String phonenumber) 


拨 一 个 电话 号 码 ,参数 phonenumber 表示 电话 号 码 。 执 行 该 方法 会 弹出 已 输 好 电话 
号 码 的 电话 软件 界面 .用 户 只 需 单 击 拨打 按钮 即 可 拨打 电话 。 


readPhoneState() 


以 对 象形 式 返 回 当 前 移动 终端 状态 和 呼叫 号 码 , 对 象 包括 incomingNumber 和 state 
属性 ,属性 incomingNumber 表示 来 电 电 话 号 码 , 属 性 state 表示 来 电 状态 。 当 属性 state 
的 值 为 idle 时 表示 空闲 状态 ; 值 offhook 表示 摘 机 状态 ,说 明 至 少 有 一 个 电话 在 活动 中 ， 
这 个 活动 或 是 拨打 (dialing) ,或 是 通话 .或 是 on hold, 并且 没有 电话 在 ringing 或 
waiting; 值 ringing 表示 来 电 状态 .电话 铃声 响起 的 那 段 时 间或 正在 通话 又 来 新 电 ,新 来 
电话 不 得 不 等 待 。 


startTrackingPhoneState () 


其 作用 是 开始 追踪 移动 终端 状态 . 当 电 话 状 态 发 生变 化 时 就 会 产生 跟踪 移动 端 状态 
的 事件 .事件 名 为 phone. 事 件 附加 的 数据 是 对 象 .对 象 包含 state 和 incomingNumber 两 
个 属性 ,其 含义 同上 。 


stopTrackingPhoneState () 
停止 追踪 移动 终端 状态 。 
10.1.3 手机 开发 


Android 为 电话 提供 了 IDLE( 待 机 ) .ACTIVE (通话 )、HOLDING( 挂 断 通 话 )、 
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DIALING( 响 铃 )、ALERTING (提醒 )、INCOMING (来 电 )、OFFHOOK ( 摘 机 )、 
WAITING( 等 待 接 通 ) .DISCONNECTED( 连 接 断 开 后 ) .DISCONNECTING( 连 接 断 开 
中 ) 等 状态 。 当 电话 来 电 和 去 电 时 .这 些 状态 会 根据 用 户 的 接听 和 挂机 等 动作 发 生 转 换 。 
来 电 状态 转换 : 空闲 状态 (IDEL) 王 二 响 铃 状态 (RINGING) 一 二 接听 状态 COFFHOOK) 
一 二 挂 断 进入 空闲 (IDEL) .或 者 从 空闲 状态 (IDEL) 一 二 响 铃 状态 (RINGING) 一 二 拒 接 
进入 空闲 (IDEL)。 去 电 状态 转换 : 空闲 (IDEL) 王 二 响 铃 或 接听 状态 COFFHOOK ) 王 二 
挂机 进入 空闲 状态 (IDEL) 。 

下 面 是 电话 范例 ,电话 会 根据 电话 状态 决定 是 否 录 制 电话 通话 。 当 电话 处 于 offhook 
状态 且 还 未 启动 录音 时 则 启动 录音 。 当 发 现 电 话 处 于 idel 空闲 状态 且 已 启动 录音 时 , 表 
明 通话 已 结束 , 则 停止 录音 退出 应 用 。 电 话 录 音 最 长 录音 时 间 是 60s。 

【 例 10-1】 (代码 位 置 ; \10\phoneRec. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 

droid. startTrackingPhoneState(); // 开 始 监听 电话 状态 
var d=new Date () 

var day=d.getDate() ; 

var month= d. getMonth(+1; 

var year= d. getFullYear () ; 


var file= /sdcard/ “+ day+ ”+month+ ”+yeart+”. wma”; // 录 制 的 音频 文件 
var isRec=false; // 录 制 电 话 通话 标志 
sleep(1); 

var timer= 60; // 最 长 录制 60s 


while ( timer>=0) 
{ 


var status= droid. readPhoneState(); // 读 取 电 话 状 态 
if ( (status. state=="offhook”) && ( isRec==false) ) 
{ 
isRec= true; // 设 置 正在 录音 
droid. recorderStartMicrophone (file); 
: 
if ( (status. state=="idle”) && ( isRec==true) ) 
{ 
timer=—1; // 如 电话 空闲 而 且 又 在 录音 之 中 , 则 结束 录音 和 结束 程序 
sleep(1); 
timer——; 


} 
if ( isRec==true ) 

droid. recorderStop (0) ; 
droid. stopTrackingPhoneState(); 
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10.2.1 短 消息 API 


N02 


开发 人 员 借 助 SL4A 提供 的 短 消息 API 可 以 发 送 短 消息 、 标 识 短 消息 阅读 状态 、 查 
看 短 消息 数量 和 查看 短 消息 服务 中 心 等 。 下 面 是 短 消息 API 说 明 。 


smsDeleteMessage (Integer id) 


删除 指定 短 消息 ,如 果 短 消息 被 成 功 删除 则 返回 true, 参 数 id 是 短 消息 标识 符 。 


smsGetAttributes () 


查询 所 有 可 能 的 短 消 息 属性 列表 。 表 10-1 列 出 了 短 消息 所 有 可 能 的 属性 。 


表 10-1 短 消息 属性 



































属性 名 4 
id 短 消息 序号 ,用 于 标识 短 消息 ,是 自 增 字段 ,从 1 开始 自 增 
thread_id 对 话 的 序号 ,同一 个 发 信人 的 对 话 序号 相同 
address 发 件 人 地 址 , 即 手机 号 ,例如 ,139XXXXXXXX 
person 联系 人 在 联系 人 列表 中 的 序号 ,如 果 为 null 则 是 陌生 人 
二 发 件 日 期 ,单位 是 ms, 从 1970/01/01 至 今 所 经 过 的 时 间 是 long 型 ,如 
1 443 408 105 271 
date_sent 
protocol 协议 , 值 0 表示 SMS_RPOTO,1 表示 MMS_PROTO 
read 是 否 已 阅读 , 值 0 表示 未 读 , 值 1 表示 已 读 
status 状态 ,一 1 表示 已 接收 ,0 表示 完成 ,64 表示 未 定 ,128 表示 失败 
本 消息 的 类 型 ,0 表示 all 消息 .1 表示 inbox 消息 ,2 表示 sent 消息 ,3 表示 


draft 消息 ,4 表示 outbox 消息 ,5 表示 failed 消息 ,6 表示 queued 消息 





reply_path_present 


TP-Reply-Path 位 的 值 0/1 





subject 


主题 ,默认 为 空 





body 


短 消 息 内 容 





Service_center 


短信 服务 中 心 号 码 ,例如 .十 8613800755500 





locked 


是 否 锁 住 短 消息 标记 ,0 表示 未 锁定 ,1 表示 已 锁定 





error_code 


错误 代码 





seen 





短 消息 是 否 已 查看 ( 非 阅 读 ,是 指 用 短 消息 程序 显示 短 消息 标题 及 简要 内 
容 ) .0 表示 未 查看 过 ,1 表示 已 查看 过 
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续 表 
属性 名 鼎 二 4 





timed 


deleted 表示 短 消息 是 否 已 删除 .0 表示 未 删除 .1 表示 已 删除 








syc_state 





marker 





source 





bind_id 





mx_status 





mx_id 





out_time 





account 





sim_ id 


block_type 








advanced_seen 





smsGetMessageById(Integer id, JSONArray attributes) 


查询 指定 短 消息 的 属性 。 参 数 id 表示 短 消息 标识 符 ,参数 attributes 表示 属性 列表 ,该 参 
数 可 选 , 可 以 通过 设置 该 参数 读 出 短 消息 的 指定 属性 值 。 如 果 不 指 定 attributes 值 , 则 默 
认 返 回 的 是 date、id read 和 body 属性 值 。 返 回 值 是 对 象 ,对 象 属性 就 是 查询 得 到 的 短 
消息 属性 。 系 统 把 每 条 短 消息 视 为 一 条 数据 库 记 录 , 短 消息 由 若干 属性 组 成 , 它 存储 在 数 


据 库 /data/ data/com. android. providers. telephony/mmssms. db 中 。 


smsGetMessageCount (Boolean unreadOnly, String folder) 


返回 短信 息 的 数目 .参数 unreadOnly 是 布尔 值 .表示 是 否 读 取 已 阅读 的 短信 息 , 值 false 
表示 未 阅读 . 值 true 表示 已 阅读 ;参数 folder 表示 信息 存储 目录 .该 参数 可 选 . 默 认 值 是 
inbox。Android 提供 的 短 消息 目录 有 inbox、sent、draft、outbox,failed 和 queued .分别 表 
示 收 信箱 .已 发 送 . 草 稿 . 发 件 箱 发 送 失败 和 待 发 送 列表 目录 。 


smsGetMessageIds (Boolean unreadOnly, String folder) 


返回 所 有 短信 息 的 id. 参数 unreadOnly 是 布尔 值 .表示 是 否 读 取 已 阅读 的 短信 息 . 值 
false 表示 已 阅读 . 值 true 表示 未 阅读 ;参数 folder 表示 短 消息 目录 .该 参数 可 选 . 默 认 值 


是 inbox。 


smsGetMessages (Boolean unreadOnly, String folder, JSONArray attributes) 
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返回 所 有 短信 息 的 列表 .参数 unreadOnly 是 布尔 值 .表示 是 否 读 取 已 阅读 的 短信 息 . 值 
false 表示 未 阅读 , 值 true 表示 已 阅读 ;参数 folder 表示 信息 存储 目录 .该 参数 可 选 .默认 


值 是 inbox。 

smsMarkMessageRead (JSONArray ids，Boolean read) 
将 短信 息 标 记 为 已 读 , 参 数 ids 表示 短 消息 标识 符 列表 ,参数 read 是 布尔 值 .表示 是 标识 
短 消息 为 已 读 或 未 读 ,其 返回 值 是 被 标记 为 已 读 的 短 消息 的 序号 。 

smsSend (String destinationAddress, String text) 


发 送 一 条 短信 ,参数 destinationAddress 表示 收 件 人 地 址 ,通常 是 电话 号 码 , 参 数 text 是 
短信 和 内容 。 需 要 注意 的 是 ,要 控制 短 消息 长 度 和 获取 短 消息 的 发 送 状 态 。 


10.2.2 短 消 息 系统 开发 


很 多 公司 在 员工 生日 当天 都 会 发 送 短 消息 祝福 。 例 10-2 在 日 期 发 生变 化 时 会 检测 
当天 日 期 是 否 是 员工 生日 日 期 ,如 果 是 员工 生日 就 发 送 短信 。 
【 例 10-2】 〈 代 码 位 置 : \10\timeShortMsg. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 


var destinationAddress= “10086”; // 改 为 发 送 手 机 号 码 
var text=“ 今 天 是 您 的 生日 , 公司 全 体 员工 祝 您 生日 快乐 ! XXX 公司 “; 
// 设 备 日 期 发 生 改 变 时 会 发 出 此 广播 


var category= “android. intent. action. DATE_CHANGED”; 
droid. eventRegisterForBroadcast (category , true); 
var birthday= “2016/6/13”; // 员 工 生日 日 期 
while ( true ) 
{ 
droid. eventWait () ; 
var d=new Date(); 
var today= d. toLocaleDateString(); // 获 取 当 天 的 日 期 
if (birthday== today ) 
{ 
droid. smsSend (destinationAddress, text) ; 
break; 
} 
} 


droid. eventUnregisterForBroadcast (category) ; 


为 了 便于 测试 .开发 人 员 运 行 此 范例 后 .可 在 设置 中 手工 改变 日 期 或 把 时 间 设 置 成 
23:59 等 待 日 期 变化 观察 接收 短信 的 手机 是 否 收 到 短信 。 
需要 注意 .有 时 候 尽 管 日 期 发 生变 化 了 ,但 广播 android. intent. action. DATE__ 
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CHANGED 是 不 会 发 送出 去 的 ,因为 要 广播 的 日 期 比 已 经 广播 过 的 日 期 还 要 旧 。 例 如 ， 
在 模拟 器 上 设置 了 2016-06-12 23:59, 到 了 2016-06-21 00:00 的 时 候 “ 日 期 发 生变 化 ”被 
广播 了 一 次 .如果 再 把 时 间 调 回 到 2016-06-20 23:59 甚至 是 更 早 的 时 间 ,那么 日 期 发 生变 
化 这 一 信息 就 不 会 再 广播 了 .除非 把 时 间 调 到 2016-06-21 23:59 或 更 新 的 时 间 ,日 期 发 生 
变化 这 一 信息 才 会 继续 广播 出 去 。 


10.3 ”W 于 无线 通信 


10.3.1 什么 是 WiFi 及 WiFi 工作 过 程 


WiFi 的 全 称 是 Wireless Fidelity, 其 意 是 无 线 保 真 技术 ,也 可 称 为 无 线 宽 带 。 其 实 
WiFi 是 IEEE 802. 11b 的 代称 ,而 现在 它 已 是 IEEE 802. 11X 系列 无 线 通 信和 标准 的 统称 。 
AP(Access Point) 称 为 接 入 点 ,通过 它 可 以 把 移动 设备 带 入 互联 网 ,简单 地 说 ,AP 就 是 
WiFi 共享 上 网 中 的 无 线 交 换 机 , 它 是 移动 设备 进入 互联 网 的 接 入 点 。 没 有 接 入 AP 或 者 
有 接 入 AP 但 是 没有 这 个 接 入 热点 的 密码 , WiFi 设备 是 无 法 使 用 这 个 接 入 AP 上 网 的 。 
连接 到 AP 后 , 带 WiFi 功能 的 手机 、 笔 记 本 和 平板 电脑 等 移动 设备 就 可 以 高 速 地 接 入 互 
联网 从 事 收发 邮件 .上 网 查 资料 .通讯 交流 和 在 线 看 电影 等 活动 了 。 

Android 对 WiFi 有 较 好 的 支持 ,应 用 可 以 通过 WiFi 上 网 从 而 节省 流量 。 但 由 于 
WiFi 非常 耗 量 . 为 了 省 电 ,Android 的 WiFi 加 了 一 个 休眠 策略 .可 以 设置 永远 不 断 开 、 充 
电 时 不 断 开 和 锁 屏 时 断 开 。 默 认 情 况 下 当 屏 幕 被 关 掉 以 后 .如果 没 有 应 用 程序 在 使 用 
WiFi, WiFi 会 在 两 分 钟 后 进入 睡眠 状态 。 如 果 应 用 程序 想 在 屏幕 被 关 掉 后 继续 使 用 
WiFi 则 需要 锁 住 WiFi. 该 操作 会 阻止 WiFi 进入 睡眠 状态 . 当 应 用 程序 不 再 使 用 WiFi 时 
应 该 释放 WiFi 让 WiFi 可 以 进入 睡眠 状态 以 节省 电源 。 要 在 应 用 中 使 用 WiFi 功能 , 开 
发 人 员 需 要 掌握 WiFi API。 


10.3.2 WiFi API 
checkWifiState() 

检测 WiFi 状态 ,如 果 WiFi 可 用 则 返回 true。 
toggleWifiState(Boolean enabled[optional]) 

打开 或 者 关闭 WiFi, 如 果 WiFi 可 用 则 返回 true。 
wifiDisconnect () 


从 当前 连接 的 WiFi 网 络 断 开 ,操作 成 功 则 返回 true。 


wifiGetConnectionInfo() 
其 作用 是 返回 当前 连接 点 的 信息 。 返 回 值 是 对 象 .对 象 包 含 mac_address bssid ip_ 
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address ,hidden_ssid、network_id、link_speed、supplicant_state、ssid 和 rssi 等 属性 ,分 别 
表示 移动 终端 的 本 机 mac 地 址 、 接 入 点 mac 地 址 、 本 机 IP( 用 整数 表示 )、ssid 隐藏 标志 、 
网 络 ID .连接 速度 (单位 为 Mb/s)、 连 接 状 态 (scanning 和 completed 等 值 )、 网络 名 称 和 
信号 强度 ( 值 为 负数 .最 小 值 为 一 200. 值 越 大 信号 越 强 ) 。 


wifiGetScanResults() 


其 作用 是 返回 附近 连接 点 信息 。 返 回 值 是 对 象 数组 ,数组 中 的 每 个 元 素 都 是 一 个 对 象 .每 
个 对 象 表示 一 个 连接 点 .每 个 对 象 包括 ssid、bssid capabilities .level 和 frequency 等 属 
性 ,分 别 表示 连接 点 的 网 络 名 称 ,mac 地 址 、 网 络 接 入 性 能 (加 密 方式 ) .信号 强度 (负数 表 
示 ) 和 工作 频率 。 


wifiLockAcquireFull (0) 

获取 一 个 完整 的 WiFi 锁 。 
wifiLockAcquireScanOnly () 

获取 一 个 只 搜索 WiFi 的 锁 。 
wifiLockRelease() 

释放 一 个 之 前 获得 的 WiFi 锁 。 
wifiReassociate() 

重新 与 当前 的 接 入 点 关联 .操作 成 功 则 返回 true。 
wifiReconnect () 

重新 连接 到 当前 接 入 点 .操作 成 功 则 返回 true。 
wifiStartScan() 


开始 搜索 WiFi 接 入 点 .如 果 扫 描 初始 化 成 功 则 返回 true。 
10.4 蓝牙 无 线 通信 


10.4.1 什么 是 蓝牙 及 蓝牙 工作 流程 


Bluetooth 中 文 名 为 蓝牙 . 它 是 一 种 支持 设备 短 距离 通信 (一 般 是 10 一 30m 之 内 ) 的 
无 线 电 技术 。 蓝 牙 的 发 展 经 历 了 1.1.1.2.2.0.2.1.3.0.4.0.4.1 和 4.2 等 8 个 版 本 。 有 
了 蓝牙 技术 .笔记 本 电脑 ,移动 电话 和 无 线 耳机 等 移动 设备 就 能 够 无 线 互 联 交换 数据 。 蓝 
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牙 适配器 (Bluetooth Dongle) 、 蓝 牙 耳 机 (Bluetooth Headset) .蓝牙 车 载 (Bluetooth Car 
Kit) .蓝牙 GPS、 蓝 牙 鼠 标 键盘 (Bluetooth Mouse& Key) 和 蓝牙 打印 机 等 是 常见 的 蓝牙 
设备 。 

蓝牙 设备 具有 一 个 48 位 的 设备 地 址 .用 来 标识 蓝牙 设备 。 蓝 牙 基 于 跳 频 技术 传输 数 
据 , 它 将 传输 的 数据 分 割 成 数据 包 : 通 过 指定 的 蓝牙 频道 分 别传 输 数 据 包 。 蓝 牙 通 常 采 用 
点 对 点 配对 连接 方式 通信 ,主动 提出 通信 要 求 的 是 主 设备 ,被动 进行 通信 的 是 从 设备 。 在 
蓝牙 手机 和 蓝牙 耳机 通信 中 .因为 耳机 向 手机 发 起 连接 请 求 .所 以 手机 是 主 设备 ,耳机 是 
从 设备 ,但 经 过 协议 转换 ,手机 和 耳机 的 主 从 设备 角色 是 可 以 互 换 的 。 微 微 网 是 一 种 常见 
的 蓝牙 网 络 拓扑 结构 .在 一 个 微微 网 中 .一 个 蓝牙 主 设备 最 多 可 连接 7 个 蓝牙 从 设备 ,有 
且 只 有 一 个 主 设备 , 主 设备 控制 整个 微微 网 通信 , 主 设备 可 以 选择 从 设备 通信 。 

Android 从 SDK 2.0 开始 支持 蓝牙 开发 ,但 蓝牙 应 用 须 在 设备 上 运行 ,不 支持 模拟 
器 。 蓝 牙 通 信 过 程 可 分 为 4 个 步骤 : 启动 蓝牙 ;发 现 已 经 配对 或 者 可 用 的 附近 的 蓝牙 设 
备 ;连接 设备 ;在 不 同 设备 之 间 传 输 数据 。 具 体 地 说 .就 是 蓝牙 主 设备 向 从 设备 发 起 呼叫 
时 , 主 设备 会 先 找 出 周围 处 于 可 被 查找 的 蓝牙 设备 ,此 时 从 端 设备 需要 处 于 可 被 查找 状 
态 。 主 设备 找到 从 端 蓝 牙 设备 后 .与 从 端 蓝牙 设备 进行 配对 ,此 时 需要 输入 从 端 设备 的 
PIN 码 。 配 对 完成 后 ,从 设备 会 记录 主 端 设备 的 信任 信息 ,此 时 主 设备 即 可 向 从 端 设备 发 
起 连接 呼叫 。 已 配对 的 设备 在 下 次 呼叫 时 ,不 再 需要 重新 配对 。 已 配对 的 设备 ,从 设备 也 
可 以 发 起 连接 呼叫 。 连 接 建立 成 功 后 . 主 从 设备 之 间 可 进行 双向 通信 。 在 通信 状态 下 , 主 
从 设备 随时 都 可 以 发 出 中 断 通 信 请 求 。UUID 是 Universally Unique Identifier 的 简称 ， 
中 文 名 为 全 球 唯 一 标识 符 , 它 是 128 位 的 长 整数 ,用 于 标识 蓝牙 服务 。 蓝 牙 设备 提供 的 服 
务必 须 有 通用 、 独 立 、 了 唯一 的 UUID 与 之 对 应 。 也 就 是 说 ,在 同一 时 间 、 同 一 地 点 ,不 可 能 
有 两 个 相同 的 UUID 标识 的 不 同 蓝牙 服务 。 当 主 从 设备 连接 成 功 后 ,双方 都 有 不 同 的 
UUID, 分 别 用 于 标识 各 自 的 蓝牙 服务 .也 可 以 理解 UUID 为 连接 id。 


10.4.2 蓝牙 API 及 其 应 用 


bluetoothAccept (String uuid, Integer timeout) 


监听 并 接收 一 个 来 自 移 动 客 户 端 的 蓝牙 连接 .阻塞 直到 连接 建立 或 者 连接 失败 。 如 果 成 
功 接收 一 个 蓝牙 请 求 . 则 返回 一 个 新 的 UUID。 参 数 UUID 是 通用 唯一 认 别 码 .该 值 可 
选 ,默认 值 是 457807c0-4897-11df-9879-0800200c9a66。 参 数 timeout 表示 监听 超时 时 间 ， 
单位 为 ms. 值 0 表示 永远 监听 .该 参数 可 选 .默认 值 是 0。 


bluetoothActiveConnections () 


其 作用 是 返回 活动 的 蓝牙 连接 。 返 回 值 是 对 象 .该 对 象 包 括 一 个 数组 ,数组 的 键 名 为 
ssid ,数组 的 键 值 为 另 一 连接 方 蓝 牙 设备 的 硬件 地 址 , 键 名 和 键 值 对 组 成 的 数组 元 素 构 成 
一 个 蓝牙 连接 。 


bluetoothConnect (string uuid，string address) 
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通过 蓝牙 与 一 个 移动 服务 器 端 进行 连接 ,阻塞 直到 连接 建立 或 者 连接 失败 .连接 建立 成 功 
则 返回 一 个 新 的 UUID。 此 处 的 UUID 必须 与 移动 服务 器 端 使 用 的 UUID 相 匹 配 ,否则 
连接 会 失败 。 参 数 address 是 可 选 的 ,如 果 未 提供 此 参数 ,将 向 用 户 显示 一 个 已 发 现 的 可 
连接 的 设备 列表 供用 户 选 择 。 


bluetoothDiscoveryCancel() 


取消 搜索 蓝牙 设备 进程 ,也 就 是 说 当 正 在 搜索 设备 时 调用 这 个 方法 将 不 再 继续 搜索 ,成 功 
取消 则 返回 true, 否则 返回 false。 


bluetoothDiscoveryStart () 
开始 搜索 蓝牙 设备 发 现 进程 ,成 功 则 返回 true, 否 则 返回 false。 


bluetoothGetConnectedDeviceName (String connID) 


获取 已 连接 的 设备 名 称 (是 指 手 机 名 而 非 蓝 牙 设备 名 称 ) ,参数 connID 表示 ssid, 该 参数 
可 选 ,默认 值 是 null。 


bluetoothGetLocalAddress () 
获取 本 地 蓝牙 设备 的 硬件 地 址 ,例如 00:00:66:55:82:02。 
bluetoothGetLocalName () 


获取 蓝牙 可 见 设备 的 名 称 (是 指 蓝牙 名 称 .而 非 手机 名 称 ) 。 


bluetoothGetRemoteDeviceName (String address) 


获取 远程 蓝牙 设备 的 名 称 , 参 数 address 表示 远程 蓝牙 设备 地 址 。 如 果 不 能 解析 蓝牙 地 
址 则 返回 null。 


bluetoothGetScanMode () 


获取 蓝牙 搜索 模式 .返回 值 一 1 表示 蓝牙 不 可 用 .0 表示 蓝牙 不 可 发 现 且 不 可 连接 ,1 表示 
可 连接 但 不 可 发 现 .3 表示 可 连接 可 发 现 。 


bluetoothMakeDiscoverable (integer duration) 


设置 蓝牙 连接 在 一 段 时 间 内 为 可 搜索 可 见 状态 。 参 数 duration 是 移动 终端 蓝牙 可 见 时 
间 , 是 可 选 的 .默认 值 是 300, 以 s 为 单位 。 


bluetoothRead (integer buffersize, String connID) 
读 取 指 定 长 度 的 数据 .长 度 由 buffersize 参数 指定 .该 参数 可 选 .默认 值 为 4096. 参 数 
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connID 是 连接 id 函数 返回 ASCII 编码 的 字符 串 。 


bluetoothReadBinary(Integer bufferSize，String connID) 


读 取 指定 长 度 的 数据 .其 编码 是 base64: 长 度 由 buffersize 参数 指定 .该 参数 可 选 ,默认 值 
为 4096 ,参数 connID 是 连接 id。 


bluetoothReadLine (String connID) 
读 取 下 一 行 数据 ,参数 connID 表示 连接 id, 参 数 可 选 ,默认 值 为 null。 
bluetoothReadReady (String connID[optional, default]: Connection id) 
判断 是 否 全 部 读 取 完成 ,如 还 有 后 续 数据 可 供 读 取 则 返回 true。 


bluetoothStop (String connID) 


停止 蓝牙 连接 ,参数 connID 表示 SSID, 可 选 . 默 认 值 为 null。 


bluetoothWrite(String ascii, String connID) 


通过 当前 打开 的 蓝牙 连接 传送 ASCII 编码 数据 .参数 ascii 表示 要 传送 的 数据 ,参数 
connID 是 ssid, 可 选 ,默认 值 是 null。 


bluetoothWriteBinary(String base64，String connID) 


通过 当前 打开 的 蓝牙 连接 传送 base64 编码 数据 .参数 base64 表示 要 传送 的 数据 ,参数 
connID 是 ssid, 可 选 .默认 值 是 null。 


checkBluetoothState() 


检测 蓝牙 连接 的 状态 。 值 一 1 表示 蓝牙 已 被 禁止 使 用 . 值 0 表示 蓝牙 不 可 连接 不 可 搜索 ， 
值 1 表示 蓝牙 可 连接 但 不 可 搜索 . 值 3 表示 蓝牙 可 连接 可 搜索 发 现状 态 。 


toggleBluetoothState (Boolean enabled，Boolean prompt) 


打开 或 者 关闭 蓝牙 .如 果 蓝 牙 可 用 . 则 返回 true。 参 数 enabled 是 布尔 值 . 表 示 是 否 打 开 
或 关闭 蓝牙 , 值 true 表示 打开 . 值 false 表示 关闭 .该 参数 可 选 .默认 值 是 true。 参 数 
prompt 是 布尔 值 .表示 是 否 提示 用 户 当前 蓝牙 状态 已 改变 . 值 true 表示 提示 . 值 false 表 
示 不 提示 .该 参数 可 选 .默认 值 是 true。 

例 10-3 是 蓝牙 点 对 点 收发 数据 实例 .该 例 由 服务 端 (从 设备 ) 和 客户 端 ( 主 设备 ) 组 
成 .服务 端 监听 客户 端 连接 并 发 送 HELLO 字符 串 给 客户 端 .客户 端 向 服务 端 发 起 连接 并 
显示 服务 器 发 送 过 来 的 字符 串 。 实 例 由 文件 btServer. js 和 btClient. js 组 成 ,分别 是 服务 
端 和 客户 端 代码 。 
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【 例 10-3〗 〈 代 码 位 置 : \10\bluetooth\) 
客户 端 文 件 btClient. js: 





load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android= new Android(); 

android. toggleBluetoothState (true) ; 

android. bluetoothConnect () ; 

var message=android.bluetoothReadLine () ; 

print (message) ; 

android. toggleBluetoothState (false) ; 


服务 器 端 文件 btServer. js: 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android= new Android(); 

android. toggleBluetoothState (true); 

android. bluetoothMakeDiscoverable(); 

android. bluetoothAccept (); 

var result= “HELLO”; 

Tesult=android.bluetoothWrite( result \r\n’”); 

android. toggleBluetoothState (false) ; 


先 在 一 台 移 动 设备 上 启动 服务 端 , 再 在 另 一 台 移 动 设备 上 启动 客户 端 ,最 后 字符 串 
HELLO 会 显示 在 客户 端 。 

例 10-4 是 聊天 室 系 统 实例 ,聊天 室 系 统 能 用 两 部 手机 点 对 点 聊天 , 它 是 一 个 收发 数 
据 功 能 和 显示 数据 功能 相 融 合 的 程序 。 实 际 应 用 时 , 需 设 一 部 手机 为 服务 器 (从 设备 ), 另 
一 部 为 客户 端 ( 主 设备 ) 。 服 务 器 监听 连接 .客户 端 发 起 连接 ,服务 器 和 客户 端 采用 双向 同 
步 通信 ,这 意味 两 部 手机 都 能 收发 聊天 信息 和 显示 聊天 信息 .但 只 能 发 完 一 条 聊天 信息 才 
能 接收 下 一 条 聊天 信息 。 下 面 是 聊天 室 系 统 的 实现 。 

【 例 10-4〗 〈 代 码 位 置 : \10\bluetooth\bluetoothChat. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var android=new Android(); 


android. toggleBluetoothState (true); 

android. dialogCreateAlert( 是否 设 为 服务 器 ? ) ; 
android. dialogSetPositiveButtonText( 是 ) ; 
android. dialogSetNegativeButtonText( 否 "); 
android. dialogShow() ; 

var result=android. dialogGetResponse(); 


var is_server=result. which==’”positive’; 


if (is_server==true ) 
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android. bluetoothMakeDiscoverable(); 
android. bluetoothAccept () ; 
else 
android. bluetoothConnect () ; 
if (is_server==true ) 
{ 
result=android. dialogGetInput( 聊天 '，’ 请 输入 聊天 信息 ) ; 


if ( (result==null) ) 

die( “服务 器 运行 结束 !) ; 
result= json_encode (result) ; 
android.bluetoothWrite( result \n”); 


} 


while(true) 
{ 
var message= android. bluetoothReadLine(); 
message= message; 
message= json_decode (message) ; 
android. dialogCreateAlert( 聊天 信息 已 收 到 ,message); 
android. dialogSetPositiveButtonText (确认); 
android. dialogShow() ; 
android. dialogGetResponse(); 
result=android. dialogGetInput( 聊天 "，’ 请 输入 聊天 信息 '); 


if ( (result==null) ) 

break; 
result= json_encode (result) ; 
android.bluetoothWrite(“result \n”); 


} 


程序 启动 后 会 提示 用 户 选择 角色 ,一 个 是 服务 器 角色 . 另 一 个 客户 端 角色 , 先 启动 的 
手机 可 设 为 服务 器 角色 ,后 启动 的 手机 可 设 为 客户 端 角色 。 之 后 输入 聊天 信息 和 显示 聊 
天 信息 功能 会 轮流 切换 ,用户 需要 按 输入 聊天 信息 和 显示 聊天 信息 交替 次 序 使 用 程序 。 
10-1 是 聊天 室 系统 截图 .其 中 .图 10-1(a) 提 示 用 户 选 择 服务 器 和 客户 端 角色 .图 10-1 
(b) 请 求 用 户 输入 聊天 信息 .图 10-1(c) 显 示 了 对 方 发 来 的 聊天 信息 。 需 要 注意 的 是 ,蓝牙 
实例 需要 准备 两 部 手机 .而 且 这 两 部 手机 要 支持 蓝牙 设备 ;为 了 便于 开发 .两 部 手机 最 好 
先进 行 配对 .再 运行 蓝牙 实例 程序 。 
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(a) 角色 选择 (b) 输入 聊天 信息 (c) 显示 聊天 信息 


图 10-1 聊天 室 系 统 


105 传 感 设 备 


10.5.1 GPS 概念 和 API 


在 地 球 仪 上 ,可 以 看 到 一 条 条 纵横 交错 的 线 , 这 就 是 经 纬 线 。 连 接 南北 两 极 的 线 , 叫 
经 线 , 和 经 线 相 垂 直 的 线 叫 纬 线 。 赤 道 是 最 长 的 纬 线 , 纬 度 为 0 .整个 地 球 沿 着 赤道 向 南 
北 各 分 为 90 份 ,每 份 为 1 。 南 纬 90 "是 南极 ,北纬 90 "是 北极 ,北纬 为 正 数 , 南 纬 为 负数 。 
通过 英国 伦敦 格林 尼 治 天 文 台 旧址 的 那 条 经 线 是 零度 经 线 . 也 叫 本 初子 午 线 。 整 个 地 球 
由 本 初子 午 线 向 东 和 向 西 分 别 分 成 180 份 ,每 一 根 经 线 都 有 其 相对 应 的 数值 ,也 就 是 经 
度 , 每 条 经 线 之 间 相 差 1". 东 经 为 正 数 . 西 经 为 负数 。 经 纬度 是 经 度 与 纬度 的 合 称 ,由 经 
纬度 组 成 的 坐标 系统 称 为 地 理 坐标 系统 。 一 个 经 度 和 一 个 纬度 一 起 确定 地 球 上 一 个 地 点 
的 精确 位 置 。 

GPS 定位 是 目前 最 为 精确 .应 用 最 为 广泛 的 定位 导航 技术 .以 后 将 会 成 为 每 一 个 移 
动 设 备 的 标 配 之 一 。GPS 是 英文 Global Positioning System (全 球 定位 系统 ) 的 简称 。 
GPS 起 始 于 1958 年 美国 军 方 的 一 个 项 目 .1964 年 投入 使 用 .到 1994 年 ,全 球 覆盖 率 高 达 
98% 的 24 颗 GPS 卫 星星 座 已 布设 完成 。GPS 系统 包括 三 大 部 分 : 空间 部 分 (GPS 卫星 
星座 ) ;地 面 控制 部 分 (地 面 监控 系统 ) ;用 户 设 备 部 分 (GPS 信号 接收 机 ) 。GPS 系统 的 主 
要 特点 有 : 高 精度 ,全 天 候 、 高 效率 、 多 功能 ,操作 简便 和 应 用 广泛 等 。 

运行 于 宇宙 空间 的 每 颗 GPS 卫星 其 位 置 是 已 知 的 .它们 时 刻 不 停 地 通过 卫星 信和 号 向 
全 球 广播 自身 当前 地 理 位 置 及 发 出 时 的 时 间 戳 信息 。 任何 一 个 GPS 接收 器 都 可 以 接收 
到 这 些 信息 .GPS 接收 器 收 到 某 卫 星 的 地 理 位 置 和 时 间 戳 信息 后 .用 当前 时 间 ( 由 GPS 接 
收 器 确定 ) 减 去 时 间 戳 上 的 时 间 , 这 个 时 间 差 就 是 信息 在 空中 传输 所 耗 的 时 间 。 用 这 个 时 
间 差 乘 上 卫星 信号 的 传输 速度 . 乘 值 就 是 信息 在 空中 传输 的 距离 ,这 也 是 该 卫星 到 GPS 
接收 器 的 距离 。 当 获取 多 颗 卫 星 (至 少 三 颗 ) 的 距离 后 .通过 计算 就 可 确定 GPS 接收 器 的 
地 理 位 置 .获取 卫星 数 越 多 .其 计算 结果 就 更 精确 .但 运算 速度 也 会 随 之 下 降 。 除 了 GPS 
可 以 定位 .网 络 和 基站 也 可 实现 定位 .只 是 定位 的 精度 会 有 所 不 同 .一般 说 来 .GPS 定位 
精度 较 高 .网 络 定位 精度 次 之 .基站 定位 精度 最 低 。 

每 一 经 度 和 纬度 可 以 细 分 为 60 分 .每 一 分 可 以 再 分 为 60 秒 以 及 秒 的 小 数 。 经 纬度 
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可 以 用 十 进 制 浮 点 数 表 示 ,例如 116. 397428 。 


startLocating(Integer minDistance, Integer minUpdateDistance) 


开始 采集 地 理 信息 数据 .参数 minDistance 表示 两 次 采集 的 时 间 差 .单位 为 ms, 默 认 
值 为 60 000ms, 即 一 分 钟 采集 一 次 ;参数 minUpdateDistance 表示 两 次 采集 最 小 的 更 新 距 
离 ,以 m 为 单位 ,默认 值 为 30m。 


stopLocating() 


停止 采集 地 理 信息 数据 。 


readLocation() 


以 对 象形 式 返 回 所 有 提供 商 提 供 的 当前 地 理 信息 数据 。 返 回 的 对 象 可 能 会 包括 passive、 
gps、network 等 属性 (分 别 对 应 基站 、GPS 和 WiFi 定位 技术 ) ,实际 上 每 个 属性 都 是 一 个 
对 象 ,这 样 的 对 象 都 包括 time、 speed、altitude、 bearing、 provider、 longitude、 latitude 和 
accuracy 等 属性 。time 表示 时 间 戳 ;speed 表示 速度 , 浮 点 数 , 以 m/s 为 单位 ;altitude 表 
示 海 拔高 度 , 浮 点 数 ,以 mm 为 单位 ,如 果 是 网 络 定位 则 此 值 为 零 ;bearing 表示 方向 ,以 度 
为 单位 ,如 果 是 基站 或 网 络 定位 ,此 值 为 零 ;provider 表示 提供 者 .字符 串 , 如 果 是 GPS 定 
位 , 则 provider 值 为 gps, 如 果 是 网 络 定位 . 值 为 network;longitude 表示 经 度 , 浮 点 数 ,以 
度 为 单位 ;latitude 表示 纬度 , 浮 点 数 , 以 度 为 单位 ;accuracy 表示 精度 , 浮 点 数 , 以 m 为 单 
位 ,GPS 定位 精度 能 达 5m。 


locationProviders() 
返回 设备 上 所 有 有 效 的 提供 商 。 
locationProviderEnabled () 
询问 地 理 位 置 提供 商 是 否 使 能 。 
getLastKnownLocation() 
返回 设备 最 近 一 次 的 地 理 信息 数据 .其 数据 格式 同 函 数 readLocation 返回 值 相同 。 


geocode (Doublelatitude, Doublelongitude, IntegermaxResults) 


以 对 象 数 组 形式 返回 指定 经 纬度 对 应 的 地 址 列表 。 参数 latitude 是 纬度 , 浮 点 数 ; 
longitude 是 经 度 . 浮 点 数 ;参数 maxResults 指定 了 地 址 列表 的 数 容量 (数组 元 素数 ) . 正 
整数 。 数 组 中 的 每 个 元 素 都 是 一 个 对 象 . 是 经 纬度 解析 出 的 一 个 地 址 .对 象 由 locality、 
admin_area 和 thoroughfare 三 个 属性 组 成 .分 别 表示 市 .省 和 街道 名 .字符 串 数据 类 型 。 
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10.5.2 GPS 测 距 和 定位 开发 


对 于 两 个 点 ,在 纬度 相等 的 情况 下 : 经 度 每 隔 0. 000 01”, 距离 相差 约 1m; 每 隔 
0. 0001 ,距离 相差 约 10m; 每 隔 0. 001”, 距离 相差 约 100m; 每 隔 0. 01”, 距离 相差 约 
1000m:; 每 隔 0.1 ,距离 相差 约 10 000m。 对 于 两 个 点 :在 经 度 相等 的 情况 下 : 纬度 每 隔 
0. 00001" ,距离 相差 约 1. lm; 每 隔 0. 0001 ,距离 相差 约 11m; 每 隔 0. 001 ,距离 相差 约 
111m; 每 隔 0.01" ,距离 相差 约 1113m; 每 隔 0. 1" ,距离 相差 约 11 132m。 下 面 是 GPS 计算 
两 点 距离 的 实例 ,其 例 由 文件 gpsDist. xml 和 gpsDist. php 组 成 ,前 者 显示 UI, 后 者 计算 
距离 。 

【 例 10-5】 (代码 位 置 : \10\gps) 

界面 文件 gpsDist. xml: 


< ?xml] version=”1.0” encoding= “utf- 8”?> 
<LinearLayout xmlns:android= “http://schemas. android. com/apk/res/android” 
android:id=“@+id/background” 
android:orientation= “vertical” android:layout width= “match_ parent” 
android:layout_height= “match_parent” android:background=“#ff000000”> 
<LinearLayout android:layout width= “match parent” 
android:layout_height =” wrap _ content ” android: id =” @ + id/ 
linearLayout1”> 
《Button android:id=“@+id/button1” 
android:layout width=“wrap_content” 
android:layout height=“wrap_content” 
android:text= “GPS 获取 始点 > 
< /Button> 
“Button android:id=“@+id/button2” android:layout_width= “wrap_content” 
android:layout_height= “wrap_content” 
android:text= “GPS 获取 终点 > 
< /Button> 
“Button android:id=“"@+id/button3” android:layout_width= “wrap_content” 
android:layout height=“wrap_content” 
android:text= 计算 距离 "> 
《VButton> 
《Button android:id= “@+ id/button4” 
android:layout width=“wrap_content” 
android:layout_height=“wrap_content”android:text= ”退出 ”> 
< /Button> 
< /LinearLayout> 
<TextView android:layout width= “match parent” 
android:layout _ height= “wrap_content” 
android:text= “始点 纬度 
android:id=“@+id/textlatitudel” 
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脚本 文件 gpsDist. js: 
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latl= latl. text; 

lonl= lonl. text; 

lat2= lat2. text; 

lon2= lon2. text; 

dist=distance(lonl, latl, lon2, lat2); 

droid. fullSetProperty(“textDistance”, “text”, “距离 =+dist+” 米 ”); 


///1on 为 经 度 , lat 为 纬度 

function distance (lonl, latl, lon2, lat2){ 
return (2* Math. atan2(Math. sqrt (Math. Sin((latl- lat2) * Math. PI/180/2) 
x* Math.Sin((latl- lat2) * Math. PI/180/2)+ 
Math. Cos (lat2 * Math. PI/180) * Math. Cos (latl x* Math. PI/180) 
x* Math. Sin((lonl1- lon2) * Math. PI/180/2) 
* Math. Sin((lon1- lon2) * Math. PI/180/2)), 
Math. sqrt (1- Math. Sin((lat1- lat2) * Math. PI/180/2) 
* Math.Sin((latl- lat2) * Math. PI/180/2) 
+Math. Cos (lat2 * Math. PI/180) * Math. Cos (latl * Math. PI/180) 
* Math. Sin((lonl- lon2) * Math. PI/180/2) 
x Math. Sin((lonl- lon2) * Math. PI/180/2)))) * 6378140; 


function file_get_contents (fileName) { 
var file=new java. io. File (fileName); 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 


var fileString=““; 

// 一 次 读 入 一 行 , 直到 读 入 null 为 文件 结束 

while ((tempString= reader. readLine()) !=null) { 
fileString=fileString+tempString ; 

} 

reader. close(); 


return fileString; 


程序 运行 结果 如 图 10-2 所 示 . 用 户 可 以 在 文本 框 中 手工 输入 或 通过 GPS 自动 采集 
始终 点 的 经 纬度 。 

下 面 是 定位 实例 .程序 运行 后 会 先 自动 采集 当前 经 纬度 .然后 根据 经 纬度 定位 地 址 ， 
由 于 采集 地 理 信 息 数 据 需 耗 费 一 定时 间 :因此 需要 等 待 . 当 出 现 事件 location 时 则 表示 已 
经 采集 到 地 理 信息 数据 。 运 行程 序 前 需 设置 GPS 为 网 络 定位 。 10-3 是 程序 运行 结 
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果 : 它 显示 了 经 纬度 对 应 的 省 市 街 名 。 


GPS 获取 始点 晶 GPS 获取 终点 





省 份 : 海南 省 


市 名 : 海南 省 直辖 县 级 行 


政 单位 


街道 : Be 村 证 打 





图 10-2 程序 运行 结果 图 10-3 地 址 定位 


【 例 10-6】 〈 代 码 位 置 : \10N\geo.js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var android= new Android(); 


android. startLocating() ; 

android. eventWaitFor (“location”, 5000); 

var gpsdata= android. readLocation () 
gpsdata= gpsdata. network; 

var longitude= gpsdata. longitude; 

var latitude= gpsdata. latitude; 

var address=android. geocode (latitude, longitude ,1); 
android. stopLocating() ; 

local=new Array() ; 

local[0]= 省份:“+ address[0].admin_area; 
local[1]= “市 名 : “+address[0]. locality; 
local[2]= “街道 : “+address[0]. thoroughfare; 
android. dialogCreateAlert (“列表 “); 

android. dialogSetItems (local) ; 

android. dialogShow (0) ; 


android. dialogGetResponse() ; 


10. 5.3 ”模拟 器 与 GPS 


如 果 要 在 模拟 器 中 调试 GPS 应 用 .有 两 种 方法 可 以 模拟 GPS 数据 。 
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Android SDK 自 带 的 DDMS 工具 模拟 GPS 数据 。 具 体 步 骤 : 在 主 菜 面 中 单 击 Emulator 
Control 标签 ,在 该 标签 视图 中 的 Longtitude 和 Latitude 文本 框 中 手动 输入 地 理 位 置 数 
据 即 可 。 

另 一 种 方法 是 使 用 geo 命令 模拟 GPS 数据 。 先 在 控制 台中 启动 命令 telnet 5554， 
5554 为 模拟 器 名 字 , 然 后 在 命令 行 下 输入 geo 命令 ,命令 格式 为 “geo fix 参数 1 参数 2 参 
数 3”, 例 如 “geo fix 116. 397428 39. 90923”, 这 三 个 参数 分 别 代 表 了 经 度 .纬度 和 海拔 
(海拔 可 选 ) 。 


10. 5.4 高 德 地 图 服务 


汽车 导航 ,就餐 地 点 定位 和 旅游 景点 位 置 标识 等 是 GPS 和 地 图 配合 使 用 的 常见 应 
用 。 高 德 地 图 是 国内 一 流 的 免费 地 图 导航 产品 ,也 是 基于 位 置 的 生活 服务 功能 最 全 面 \ 信 
息 最 丰富 的 手机 地 图 ,由 国内 最 大 的 电子 地 图 、 导 航 和 LBS 服务 解决 方案 提供 商 高 德 软 
件 ( 纳 斯 达 克 Amap) 提 供 。 应 用 JavaScript 语言 可 以 开发 高 德 地 图 应 用 。 通 过 官方 网 站 
“http://lbs. amap. com/api/javascript-api/jsapi-markdown/ 快 速 入 门 ” 可 以 快速 掌握 高 
德 地 图 服务 开发 。 要 开发 高 德 地 图 应 用 ,首先 需要 到 网 站 http://lbs. amap. com/ 
console/key 申请 开发 者 key,key 是 一 个 32 长 度 的 十 六 进 制 数字 。 然 后 引入 高 德 地 图 
JavaScript API 文件 。 接 下 来 创建 地 图 容器 和 指定 容器 尺寸 。 最 后 创建 地 图 和 进行 地 图 
其 他 操作 。 

下 面 是 创建 地 图 的 实例 , 它 将 显示 一 张 地 图 , 它 由 文件 gd.js 和 gd. htm 组 成 。 先 到 高 
德 官网 申请 开发 者 key, 把 申请 到 的 key 填 到 程序 gd. js 代码 “你 申请 的 key” 处 ,再 把 gd. js 
和 gd. htm 下 载 到 手机 的 “/ sdcard/sl4a/scripts/” 目 录 下 ,再 运行 程序 gd. js, 最 后 会 显示 出 相 
应 的 地 图 ,运行 结果 如 图 10-4 显示 , 它 是 一 张 北京 故宫 博物 院 附 近 处 的 地 图 。 

【 例 10-7】 《代码 位 置 : \10\gd) 

脚本 文件 gd. js: 





load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var obj= droid. makeToast (“MyHello, Android!”); 

droid. webViewShow(”file:///sdcard/sl4a/scripts/gd. htm”); 

droid. eventWait (10000) ; // 延 时 10s 再 结束 程序 


界面 文件 gd. htm: 


< ldoctype html> 

<html> 

<head> 

<meta charset= “utf- 8”> 

<meta http- equiv=“X-UA- Compatible” content=“IE=edge”> 


<meta name= “viewport”content= “initial- scale=1.0, user- scalable=no, width= 
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device-width”> 
《title> 地 图 显示 < /title> 
《1link rel=“stylesheet” href= “http://cache. amap. com/lbs/static/main.css” /> 
< script src=“http://webapi. amap. com/maps?v=1. 3&key= 你 申请 的 key”> < /script> 
// 引 入 高 德 地 图 文件 
< /head> 
《body> 
<div id= “mapContainer”> < /div> // 创 建 地 图 容器 
“Script> 
// 创 建 地 图 .设置 地 图 中 心 和 设置 缩放 级 别 
var map= new AMap. Map("mapContainer ，{ 
// 设置 中 心 点 
center: [116.397428, 39.90923], 
// 设置 缩放 级 别 
zoom: 12 
js 
</script> 
< /body> 
</html> 









和 


和 





ch AS ;AV 
图 10-4 北京 故宫 博物 院 附近 处 的 高 德 地 图 


10.5.5 方向 传感器 概念 和 API 


为 便于 描述 手机 的 方向 变化 .图 10-5 对 手机 的 方位 进行 了 描述 。 图 10-5 用 平行 四 
边 形 ABCD 表示 手机 .AD 右边 有 一 横 线 表示 手机 HOME = 
等 按键 ,将 其 水 平 放置 且 屏 幕 朝天 空 方向 .AD 表示 手机 底 ”HOME 键 
部 ,BC 表示 手机 头 部 .AB 表示 手机 左 侧 .DC 表示 手机 右 
侧 。 为 便于 描述 . 设 AD 方 向 为 X 轴 .AB 方向 为 Y 轴 . 屏 
幕 朝 上 方向 为 Z 轴 。 

角度 1 (azimuth, degrees of rotation around the z x 


axis) 表 示 手 机 头 部 的 指使 方向 . 它 定义 为 手机 左 侧 ( 即 向 ” 图 10-5 手机 方位 坐标 系 








尾部 
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量 ) 与 地 球 的 正 北方 的 夹 角 . 当 手机 绕 Z 轴 旋 转 时 .其 夹 角 会 发 生变 化 . 夹 角 范围 为 一 180 一 
180", 当 手机 左 侧 从 正 北方 顺 时 针 方 向 旋转 , 则 其 夹 角 为 正 值 ; 当 手 机 左 侧 从 正 北方 逆 时 
针 方向 旋转 ,其 夹 角 为 负 值 。 

角度 2(pitch, degrees of rotation around the x axis) 表 示 手 机 头 部 和 尾部 的 诱 起 状 
态 , 它 定义 为 手机 左 侧 ( 右 侧 ) 和 地 球 的 水 平面 的 角度 . 当 手 机 绕 着 X 轴 旋转 时 .该 角度 值 
会 发 生变 化 ,其 角度 范围 是 一 180” 一 180”。 当 手机 头 部 不 动 .尾部 不 断 向 上 撼动 直至 落 到 
XOY 平面 ,这 时 角度 为 正 值 , 值 渐变 增 大 ,范围 为 0 一 180 ; 当 手 机 尾部 不 动 , 头 部 不 断 向 
上 卿 动 直 至 落 到 XOY 平面 ,这 时 角度 为 负 值 , 值 渐变 减 小 .范围 为 一 180 一 0。 

角度 3(roll,degrees of rotation around the y axis) 表 示 手 机 左 侧 和 右 侧 竹 起 状态 , 它 
定义 为 手机 头 部 (尾部 ) 和 地 球 的 水 平面 的 角度 ,. 当 手机 绕 着 Y 轴 旋 转 时 ,该 角度 值 发 生 
变化 ,范围 是 一 180 一 180` 。 当 手机 右 侧 不 动 .手机 左 侧 不 断 向 上 狂 起 直至 落 到 XOY 平 
面 , 这 时 角度 为 正 值 , 值 渐变 增 大 ,范围 为 0 一 180 ; 当 手 机 右 侧 不 动 ,手机 左 侧 不 断 向 上 
才 起 直至 落 到 XOY 平面 .这 时 角度 为 负 值 , 值 渐变 减 小 :范围 为 一 180 一 0 。 

如 果 手 机 内 置 有 方向 传感器 ,就 可 以 通过 方法 sensorsReadOrientation 查询 手机 的 
方向 。 下 面 是 方法 介绍 。 


sensorsReadOrientation() 


读 取 手机 头 部 指向 状态 (角度 1) 、 头 底部 扰 起 状态 (角度 2) 和 左右 侧 手 起 状态 (角度 3)， 
以 数组 形式 返回 最 近 接 收 到 的 状态 值 。 数 组 包括 三 个 元 素 , 第 0 个 元 素 表示 角度 1， 
第 1 个 元 素 表示 角度 2, 第 2 个 元 素 表示 角度 3。 角 度 用 弧度 表示 ,弧度 值 范 围 为 

3. 141 592 653 589 一 3. 141 592 653 589。 如 果 手 机 不 支持 此 类 传感器 , 则 此 数组 的 三 个 
元 素 为 空 。 


10.5.6 方向 传感器 物体 倾斜 开发 


下 面 是 检测 物体 倾斜 的 实例 , 它 可 以 检测 头 尾 部 倾斜 度 ,以 及 左右 两 侧 的 倾斜 度 。 它 
先 通 过 方向 传感器 采集 左右 和 前 后 倾斜 值 .然后 将 倾斜 值 由 弧 值 变换 为 角度 值 , 再 然后 由 
倾斜 值 正 负 计 算出 前 后 或 后 前 倾 和 左右 或 右 左倾 .最 后 以 对 话 框 UI 向 用 户 反 馈 手 机 倾 
斜 状态 ,以 及 提示 用 户 是 否 继续 检测 手机 倾斜 状态 。 

【 例 10-8】 《代码 位 置 : \10\incline. js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 


var android= new Android(); 


android. startSensingTimed (1, 250); 
while(true) 
{ 

var directl="”; 

java. lang. Thread. sleep (1000) ; 


var ret=android. sensorsReadOrientation(); 
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var degreel=ret[1]; // 获 取 前 后 倾斜 角度 
var degree2=ret[2]; // 获 取 左 右倾 斜 角度 
if (degreel>0 ) 

direct1l=“ 头 部 朝 下 ”; 
else direct1=“ 头 部 朝 上 ”; 


degreel=Math. abs (degreel) ; 

degreel= 180/Math. PI * degreel; 

degreel= degreel. toFixed(5) ; // 保 留 5 位 小 数 
var msg= directl+ ”倾斜 "+ degreel+“ 度 。\r\n ; 


if (degree2>0 ) 
direct2=“ 左 侧 朝 上 ”; 
else direct2=“ 左 侧 朝 下 ”; 


degree2=Math. abs (degree2) ; 

degree2= 180/Math. PI x* degree2; 

degree2= degree2. toFixed (5) ; // 保 留 5 位 小 数 
msg=msg+ direct2+ “倾斜 "+ degree2+” 度 。; 


android. dialogCreateAlert (msg) ; 
android. dialogSetPositiveButtonText( 继续 检测 ) ; 
android. dialogSetNegativeButtonText( 停止 检测 ) ; 
android. dialogShow () ; 
result=android. dialogGetResponse() ; 
var is_ continue=result.which==’ positive’; 
if (is_continue==false ) 
break; 
k 


android. stopSensing(); 


用 户 启 动 程序 后 .会 跳出 对 话 框 显示 手机 倾斜 状态 .并 提示 用 户 是 否 继续 检测 手机 倾 
斜 状态 ,运行 结果 如 图 10-6 所 示 , 图 中 显示 手机 头 部 朝 上 底部 朝 下 倾斜 33. 85 , 右 侧 朝 上 
左 侧 朝 下 倾斜 10. 25 。 





图 10-6 倾斜 检测 


10.5.7 加 速度 传感器 概念 和 API 
加 速度 是 描述 物体 速度 改变 快慢 的 物理 量 .加 速度 定义 为 速度 随时 间 的 变化 率 . 加 速 
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度 是 矢量 ,其 大 小 单位 用 m/s? 表示 .其 方向 与 合成 力 的 方向 相同 。 

手机 加 速 传 感 器 是 一 种 能 够 测量 加 速度 的 电子 设备 ,这 个 加 速度 是 外 力 和 重力 共同 
对 物体 施 力 的 加 速度 。 这 个 加 速度 可 以 分 解 为 三 个 XYZ 直角 坐标 系 分 量 。XYZ 坐标 系 
将 手机 左下 角 定 义 为 原点 (手机 水 平 置 放 且 屏幕 朝天 ) ,将 屏幕 短 边 定 义 为 X 轴 ,X 轴 沿 
屏幕 向 右 ( 原 点 沿 屏 幕 短 边 方向 ) 为 正方 向 ;将 屏幕 长 边 定 义 为 Y 轴 .Y 轴 沿 着 屏幕 向 上 
(原点 沿 屏 幕 长 边 方向 ) 为 正方 向 ;将 垂直 屏幕 方向 定义 为 Z 轴 ,屏幕 朝天 为 正方 向 。 

当 手 机 Z 轴 朝 天 平 放 在 桌面 上 ,并 且 从 左 到 右 ( 原 点 沿 屏幕 短 边 方向 ) 推 动手 机 ,此 
时 又 轴 上 的 加 速度 是 正 数 。 当 手机 Z 轴 朝 天 平 放 在 桌面 上 ,并 且 从 下 到 上 (原点 沿 屏幕 
长 边 方向 ) 推 动手 机 ,此 时 立轴 上 的 加 速度 是 正 数 。 当 手机 Z 轴 朝 上 静止 平 放 在 桌面 上 ， 
则 加 速度 Z 分 量 为 设备 加 速度 (0m/s’ ) 减 去 重力 加 速度 (一 9. 81m/s*), 此 时 Z 分 量 的 加 
速度 是 十 9. 81m/s: 。 当 手机 从 空中 自由 落体 ,此 时 加 速度 Z 分 量 是 0, 因 为 加 速度 Z 分 量 
为 设备 加 速度 (一 9. 81my/s?) 减 去 重力 加 速度 (一 9. 8lmy/ss )。 当 手机 向 上 以 Am/s? 的 加 
速度 向 空中 抛 出 ,此 时 加 速度 Z 分 量 为 A 十 9.81m/s?。 

如 果 手 机 内 置 了 加 速度 传感器 ,就 可 以 通过 方法 sensorsReadAccelerometer 查询 手 
机 在 X、Y 和 Z 方 向 的 加 速度 值 。 下 面 是 方法 介绍 。 


sensorsReadAccelerometer () 


以 数组 形式 返回 手机 加 速度 在 X、Y 和 Z 方 向 的 分 量 。 第 0 个 元 素 为 X 分 量 , 第 1 个 元 素 
为 Y 分 量 ,第 2 个 元 素 是 Z 分 量 。 


10. 5.8 加 速度 传感器 手 摇 应 用 开发 


下 面 是 应 用 加 速度 开发 手 摇 应 用 的 实例 .应 用 采集 加 速度 值 , 如 果 加 速度 的 分 量 大 于 
指定 阅 值 , 则 手机 震动 。 用 户 先 启 动 程序 后 .然后 不 断 摇动 手机 两 三 秒 , 如 果 摇 动 速度 够 
快 ,那么 手机 将 震动 .否则 不 会 震动 。 

【 例 10-9〗】 《代码 位 置 : \10\Shake. js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android= new Android(); 

android. startSensingTimed(1，250) ; 

java. lang. Thread. sleep (2000) ; 

var a= android. sensorsReadAccelerometer () ; // 加 速度 


android. stopSensing(); 


var x=a[0]; //X 分 量 
var y=al[l]; /MY 分量 
var z=a[2]:; //Z 分 量 
var threshold= 15; // 阅 值 


if ((Math.abs(x)> threshold) || (Math. abs (y)> threshold) || (Math. abs(z) > threshold)) 
android. vibrate (1000); 
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10.5.9 磁力 传感器 概念 和 API 


磁场 是 指 存 在 磁力 作用 的 空间 。 磁 场 存 在 于 磁体 周围 空间 、 运 动 电荷 周围 空间 以 及 
电流 周围 空间 。 磁 感应 强度 是 用 来 描述 磁场 强 弱 和 方向 的 物理 量 ,是 矢量 。 磁 感应 强度 
越 大 表示 磁感应 越 强 ;磁感应 强度 越 小 .表示 磁感应 越 弱 。 其 方向 就 是 磁 针 在 磁场 中 某 点 
静止 时 N 极 所 指 的 方向 。 磁 场 国际 通用 单位 为 特 斯 拉 ( 符 号 为 T),1 特 斯 拉 在 数值 上 等 
于 长 度 为 1m 并 与 磁场 相 垂直 的 导线 .通过 1A 电流 时 . 它 所 受 的 电磁 力 为 1 牛顿 (N) 时 
的 磁场 感应 强度 。 磁 场 单 位 还 常用 高 斯 (G) 、 毫 高 斯 (mG) 和 微 特 斯 拉 (yT) 等 来 表示 。 
它们 之 间 的 换算 为 : lyT 二 10mG;1G 二 1000mG;1T==10 000G。 

磁场 传感器 主要 用 于 感应 其 周边 的 磁感应 强度 。 即 使 周围 没有 任何 直接 的 磁场 , 手 
机 设备 也 始终 会 处 于 地 球 磁场 中 。 随 着 手机 状态 设备 摆 放 状态 的 改变 ,周围 磁场 分 解 在 
手机 的 X、Y 和 2Z 方向 上 的 磁场 分 量 会 发 生 改变 。 这 里 的 XY 和 2Z 方向 参见 图 10-5。 手 
机 磁场 传感器 的 磁场 单位 是 微 特 斯 拉 (jyT)。 通 过 该 传感器 便 可 开发 出 指南 针 和 罗盘 等 
磁场 应 用 。 下 面 是 磁场 传感器 API。 

如 果 手 机 内 置 了 磁场 传感器 ,就 可 以 通过 方法 sensorsReadMagnetometer 查询 手机 
在 X、Y 和 Z 方 向 上 的 磁场 分 量 。 下 面 是 方法 介绍 。 


sensorsReadMagnetometer () 


以 数组 形式 返回 磁场 在 手机 X、Y 和 Z 方 向 上 的 分 量 。 第 0 个 元 素 是 X 方向 的 磁场 分 
量 ,第 1 个 元 素 是 Y 方 向 的 磁场 分 量 , 第 2 个 元 素 是 Z 方 向 的 磁场 分 量 。 


10. 5.10 磁力 传感器 磁场 检测 开发 


下 面 是 检测 磁场 分 量 的 实例 ,在 手机 X、Y 和 2 方向 附近 摆 放 磁体 .每 次 摆 放 位 置 要 
不 同 , 以 控制 台 方 式 运行 程序 观察 磁 分 量 值 .会 发 现 值 发 生 较 大 变化 ,因为 磁体 摆 放 处 具 
有 较 大 的 磁场 。 

【 例 10-10】 (代码 位 置 : \10\Msensor. js. js) 


load(“/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var android= new Android(); 

android. startSensingTimed (1, 250); 

java. lang. Thread. sleep (1000) ; 

s5=android. sensorsReadMagnetometer () ; 

android. stopSensing(); 

print("X 方 向 磁 分 量 : “+ s5[0]+“\n”); 

print (“Y 方 向 磁 分 量 :“+s5[1]+“\n”); 

print ("2Z 方向 磁 分 量 : “+ s5[2]+“\n”); 
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11.1 相机 拍摄 


11.1.1 视频 拍摄 API 


Android 手机 通常 都 带 有 前 置 和 后 置 摄像 头 , 摄 像 头 可 以 用 来 拍照 和 摄像 ,而 拍照 和 
摄像 是 Android 手机 Camera 应 用 的 主要 功能 。 和 Android 手机 相 比 ,PC 端的 Camera 
应 用 其 功能 通常 会 比较 弱 , 因 为 PC 端 通常 是 不 带 有 摄像 头 的 ,即使 安装 了 摄像 头 也 是 不 
能 移动 拍照 和 摄像 的 。 如 果 Android 摄像 头 通过 网 络 可 以 被 PC 端 访 问 ,PC 端 应 用 无 疑 
将 具有 更 强大 的 功能 ,例如 ,可 以 将 家 中 的 每 个 角落 实时 分 享 给 朋友 。SL4A 支持 在 线 摄像 
功能 ,在 线 摄像 功能 启动 后 .会 建立 起 Web 服务 器 ,服务 器 把 本 地 摄像 头 拍 摄 的 图 片 源源 不 
断 地 发 送 给 客户 端 ,图 片 支持 JPEG 格式 。 下 面 是 SL4A 提供 的 在 线 拍照 和 摄像 方法 。 


cameraStartPreview(Integer resolutionLevel, Integer jpegQuality, String filepath) 


其 作用 是 启动 视频 预览 。 参 数 resolutionLevel 表示 预览 质量 ,其 值 越 高 其 对 应 的 预 
览 质量 会 越 高 ,默认 值 为 0。 参 数 jpegQuality 表示 视频 的 jpeg 图 片 压 缩 质量 ,其 值 范围 
为 0 一 100. 默 认 值 为 20, 此 值 越 高 其 对 应 的 图 片 压缩 率 越 低 ,图片 质量 就 越 好 ,否则 反之 。 
参数 filepath 表示 jpeg 图 片 的 存储 路 径 . 此 参数 可 选 。 如 果 方 法 调用 成 功 将 返回 布尔 
值 true。 

预览 有 两 种 模式 .一 种 是 数据 模式 ,一 种 是 文件 模式 。 如 果 参 数 filepath 指定 的 存储 
路 径 是 可 读 写 的 .就 选用 文件 模式 .否则 选用 数据 模式 。 文 件 模式 会 把 预览 视频 中 的 图 片 
保存 为 jpeg 文件 .文件 存储 在 参数 filepath 指定 的 存储 路 径 。 数 据 模式 会 产生 preview 
事件 .事件 携带 format、width、height、 quality ,filename、error、encoding 和 data 等 数据 ， 
format 的 值 总 是 为 jpeg; width 和 height 表示 图 片 宽 高 ,以 像素 为 单位 ;quality 表示 jpeg 
图 片 质 量 . 其 值 范围 为 1 一 100;filename 表示 jpeg 文件 名 ;error 表示 错误 .只 有 出 现 磁盘 
满 或 文件 写 保护 等 状态 才 包 含 此 值 ;encoding 表示 数据 编码 .如 果 是 文件 模式 . 则 此 值 总 
是 为 file. 否 则 为 base64;data 表示 经 过 base64 编码 的 图 片 数 据 。 


cameraStopPreview() 
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其 作用 是 停止 视频 预览 。 


webcamAdjustQuality (Integer resolutionLevel, Integer jpegQuality) 


其 作用 是 在 启动 Web 摄像 服务 的 时 候 调 整 Web 摄像 头 的 视频 拍摄 质量 。 参数 
resolutionLevel 表示 拍摄 质量 ,其 值 越 高 其 对 应 的 拍摄 质量 会 越 高 .默认 值 为 0。 参 数 
jpegQuality 表示 视频 的 jpeg 图 片 压缩 质量 ,其 值 范围 为 0 一 100, 默 认 值 为 20, 此 值 越 高 
其 对 应 的 图 片 压 缩 率 越 低 ,图 片 质量 就 越 好 .否则 反之 。 


webcamStart (Integer resolutionLevel, Integer jpegQuality, Integer port) 


其 作用 是 启动 MJPEG 视频 流 服 务 。 参 数 resolutionLevel 表示 拍摄 质量 ,其 值 越 高 其 对 
应 的 拍摄 质量 会 越 高 ,默认 值 为 0。 参 数 jpegQuality 表示 图 片 压缩 质量 ,其 值 范围 为 0 一 
100 ,默认 值 为 20, 此 值 越 高 其 对 应 的 图 片 压缩 率 越 低 ,图 片 质量 就 越 好 ,否则 反之 。 


webcamStop () 


其 作用 是 关闭 MJPEG 视频 流 服务 。 
11.1.2 在 线 拍摄 开发 


由 于 SL4A 没有 开放 MJPEG 视频 流 的 协议 .再 加 上 部 分 Android 视频 设备 不 支持 
preview 模式 等 原因 .前 述 方法 在 不 同 设备 上 使 用 时 很 可 能 会 失败 .导致 请 求 MJPEG 服 
务 失败 。 针 对 这 个 问题 ,可 以 采用 “手机 采集 图 像 十 PC 浏览 器 预览 图 像 * 的 方法 来 解决 。 
“手机 采集 图 像 十 PC 浏览 器 预览 图 像 " 方 法 的 工作 原理 : 当 客 户 端 采用 HTTP 访问 手机 
Camera 服务 时 ,手机 端 应 用 先 捕获 Camera 图 像 并 存储 到 指定 目录 .之 后 把 图 像 文件 通 
过 HTTP 返回 给 客户 端 ,最 后 客户 端 在 浏览 器 中 预览 手机 摄像 头 中 的 景象 或 自行 开发 应 
用 保存 图 像 数据 。 下 面 是 JPEG 视频 流 实例 , 当 浏 览 器 客户 端 通过 HTTP 请 求 拍摄 服务 
时 ,应 用 会 先 拍摄 图 像 并 存储 图 像 文件 ,再 通过 HTTP 把 图 像 文件 传递 给 浏览 器 客户 端 。 
实例 由 CapturePicture. js 和 CapturePicture. htm 组 成 ,前 者 负责 采集 和 传递 图 像 ,后 者 

责 显示 图 像 。 运 行 此 实例 前 ,需要 把 CapturePicture. htm 中 的 代码 “手机 端 IP" 修 改 为 
实际 手机 的 IP 地 址 。 先 在 手机 端 运行 CapturePicture. js 程序 ,之 后 在 PC 端 浏 览 器 运行 
CapturePicture. htm 可 访问 手机 端 摄像 头 。 实 例会 每 隔 2 秒 请 求 显示 采集 到 的 图 像 。 为 
了 提供 成 功率 ,手机 和 PC 最 好 要 在 同一 个 局 域 网 中 运行 。 

【 例 11-1】 (代码 位 置 : \11\CapturePicture) 

文件 CapturePicture. htm: 


<html> 

<head> 

《title> 实 时 视频 < /title> 

<meta http- equiv= “refresh” content= “2” /> 
< /head> 


223 | 


Hrd 向 只 启用 下 册 息 下 


文件 CapturePicture. js: 
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osw. write(tmpHttpHeader. getBytes (“UTF8”), 0, tmpHttpHeader. length() ) ; 


tmpHttpHeader= new java. lang. String(“Content- Type: image/ jpeg\r\n\r\n”); 
osw. write(tmpHttpHeader. getBytes (“UTF8”), 0, tmpHttpHeader. length() ) ; 
osw. write (imagebuffer, 0, imageFilelen) ; // 发 送 图 片 

osw. flush () ; 

java. lang. Thread. sleep (1000) ; 

bufferedReader. close() ; 

osw. close() ; 


socket. close(); 
} 
// 功 能 : 读 出 图 像 文 件 
function readImage (fileName) { 
var tempbuffer= java. lang. reflect. Array. newInstance (java. lang. Byte. TYPE, 1024 * 
1024) ; 
var imagepos=0; 
var byteread=0; 
var fin=new java. io.FileInputStream(fileName) ; 
// 读 入 多 个 字 节 到 字 节 数组 中 ,byteread 为 一 次 读 入 的 字 节 数 
while ((byteread=fin. read(tempbuffer)) !=-1){ 
java. lang. System. arraycopy( tempbuffer, 0, imagebuffer, imagepos, byteread ); 
imagepos= imagepos+ byteread; 
} 
fin.close(); 
imageFilelen= imagepos; 
} 
var imageFilelen=0; // 图 像 文件 实际 长 度 
// 图 像 文 件 最 大 10MB 


var imagebuffer= java. lang. reflect. Array. newInstance (java. lang. Byte. TYPE, 10 * 1024 * 


1024) ; 

readImage(”/sdcard/sl4a/scripts/r_lena. jpg”); 

t= java. lang. Thread (myobj) ; // 开 启 线程 
t. start (); 


112 多 媒 体 


11.2.1 多 媒体 简 述 


多 媒体 可 以 使 移动 应 用 更 加 绚丽 多 彩 . 在 应 用 程序 中 使 用 多 媒体 可 以 显著 地 增强 应 
用 程序 的 吸引 力 、 实 用 性 和 功能 性 。 现 今 的 移动 设备 都 会 内 置 麦克 风 、 摄 像 头 和 扬声器 ， 
通过 它们 可 以 录制 语音 .采集 视频 或 图 像 .播放 不 同音 频 编码 文件 。SL4A 支持 MP3、 
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WMA、AAC 和 AMR 等 音频 编码 。MP3 全 称 为 Moving Picture Experts Group Audio 
Layer 型 ,是 一 种 音频 压缩 技术 , 它 可 以 大 幅度 地 降低 音频 数据 量 , 它 的 音频 压缩 率 可 以 
达 1 :10 甚至 1: 12, 压 缩 前 后 的 音质 没有 了 明显 下 降 , 正 是 因为 MP3 具有 体积 小 和 音质 
高 的 特点 ,使 得 MP3 几乎 成 为 网 上 音乐 的 代名词 。WMA 的 全 称 是 Windows Media 
Audio, 是 微软 公司 力 推 的 一 种 音频 格式 。WMA 格式 是 以 减少 数据 流量 但 保持 音质 的 方 
法 来 达到 更 高 的 压缩 率 目 的 ,其 压缩 率 一 般 可 以 达到 1 : 18, 生成 的 文件 大 小 只 有 相应 
MP3 文件 的 一 半 , 但 在 音质 方面 .尤其 是 在 高 位 元 率 下 , WMA 无 法 和 MP3 相 抗 衡 。 
AAC(Advanced Audio Coding) 是 一 种 专 为 声音 数据 设计 的 文件 压缩 格式 , 它 是 在 MP3 
的 基础 上 发 展 而 来 .相对 于 MP3.AAC 具有 音质 更 佳 和 文件 更 小 的 优点 ,但 目前 并 没有 
普及 。AMR(Adaptive Multi-Rate) 是 一 种 音频 压缩 编码 ,AMR 又 可 分 为 amr-nb 和 amr- 
wb 两 种 编码 ,通常 所 说 的 AMR 一 般 是 指 amr-nb, 其 采样 率 为 8000Hz, 支 持 4. 75、5. 15、 
5.9、6.7、7.4、7.95、10.2 和 12.2kb/s 等 8 种 比特 率 。AMR 的 优势 是 文件 容量 很 小 ,每 
秒 钟 的 AMR 音频 大 小 可 控制 在 1KB 左右 ,即便 是 长 达 一 分 钟 的 音频 文件 ,也 能 符合 中 
国 移动 现行 的 彩信 不 超过 50KB 的 技术 规范 ,手机 铃声 通常 采用 AMR 格式 。 由 于 AVI、 
WMV、MP4 、3GP FLV 等 视频 所 采 的 音频 编码 是 MP3、AAC、WMA 和 AMR ,所 以 系统 
可 以 播放 视频 文件 中 的 音乐 。 

在 图 像 方面 .SL4A 支持 PNG 和 JPEG 等 格式 。JPEG 是 Joint Photographic 
Experts Group( 联 合 图 像 专家 组 ) 的 缩写 ,文件 后 缀 名 为 . jpg 或 . jpeg, 是 最 常用 的 图 像 文 
件 格式 ,其 采用 的 是 有 损 压 缩 算 法 .能 够 将 图 像 压缩 在 很 小 的 储存 空间 。 由 于 图 像 中 重复 
或 不 重要 的 资料 会 被 丢失 ,因此 容易 造成 图 像 数 据 的 损伤 。PNG 全 称 为 Portable 
Network Graphics( 便 携 式 网 络 图 形 ) .采用 的 是 无 损 压 缩 算法 . 它 在 不 丢失 数据 的 情况 下 
尽 可 能 压缩 图 像 数据 。 两 者 最 明显 的 区 别 就 是 PNG 格式 可 以 保存 为 透明 背景 的 图 片 ， 
JPEG 就 不 可 以 。 


11.2.2 多 媒体 录制 API 


SL4A 提供 了 多 媒体 录制 方法 ,通过 这 些 方法 可 以 录制 带 声 音 和 不 带 声音 的 视频 图 
像 文件 ,以 及 纯音 频 文 件 。 视 频 和 音频 文件 只 能 存储 在 SDCARD 中 ,其 存储 路 径 必须 是 
“/sdcard/ 文 件 名 ”或 “/sdcard/ 子 目录 /文件 名 ”. 例 如 ,存储 路 径 可 以 是 “/sdcard/file. 
mp4”。 如 果 存 储 路 径 为 /mnt/sdcard2/ 文 件 名 ”, 即 使 此 目录 存在 并 可 以 正常 读 写 ,那么 
多 媒体 录制 方法 将 失效 .不 能 正常 录制 音 视 频 文件 。 录 制 音 视频 文件 时 ,系统 将 根据 多 媒 
体 文件 的 扩展 名 使 用 默认 的 多 媒体 音 视频 编码 。 如 果 多 媒体 文件 的 扩展 名 为 3gp 或 
mp4 ,系统 将 使 用 通用 的 h264 编码 录制 音 视频 文件 。 下面 是 多 媒体 录制 方法 的 形式 
定义 。 

recorderCaptureVideo (String targetPath, Integerduration (optional), Boolean recordAudio 

(optional)) 


其 作用 是 从 摄像 头 录制 音 视频 信息 并 保存 到 指定 的 存储 路 径 。 参 数 targetPath 表示 
存储 路 径 , 其 路 径 形 式 必 须 为 “/sdcard/ 文 件 名 ”或 “/sdcard/ 子 目录 /文件 名 ”。 参数 
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duration 表示 录制 时 间 ,以 s 为 单位 。 录 制 过 程 会 堵塞 程序 的 执行 。 参 数 duration 是 可 
选 的。 如 果 没 有 提供 参数 duration ,那么 方法 将 立即 返回 (放弃 堵塞 ) 并 关闭 掉 录 制 屏 幕 ， 
但 录制 工作 并 没有 结束 ,录制 工作 会 一 直 在 后 台 运 行 ,直到 程序 结束 或 调用 了 停止 录制 方 
法 recorderStop。 方 法 recordAudio 表示 是 否 录制 音频 ,如 果 值 为 true 表示 录制 音频 ,和 否 
则 表示 不 录制 音频 ,该 参数 是 可 选 的 ,默认 值 为 true。 


recorderStartMicrophone (String targetPath) 


其 作用 是 从 microphone 中 录制 音频 文件 ,参数 targetPath 表示 存储 路 径 。 


recorderStartVideo (String targetPath, Integerduration (optional )， IntegervideoSize 
(optional)) 


其 作用 是 从 摄像 头 录制 音 视频 信息 并 保存 到 指定 的 存储 路 径 。 参 数 targetPath 表示 
存储 路 径 , 其 路 径 形 式 必 须 为 “/sdcard/ 文 件 名 ”或 /sdcard/ 子 目录 /文件 名 ”。 参 数 
duration 表示 录制 时 间 , 以 s 为 单位 。 录 制 过 程 会 堵塞 程序 的 执行 。 参 数 duration 是 可 
选 的 。 如 果 参 数 duration 值 为 0 那么 方法 将 立即 返回 (放弃 堵塞 ) 并 关闭 掉 录 制 屏幕 ,但 
录制 工作 并 没有 结束 ,录制 工作 会 一 直 在 后 台 运 行 ,直到 程序 结束 或 调用 了 停止 录制 方法 
recorderStop 。 参 数 videoSize 表示 视频 分 辩 率 ,如 果 值 为 0 则 表示 160X 120; 如 果 值 为 
1 则 表示 320X 240; 如 果 值 为 2 则 表示 352X288; 如 果 值 为 3 则 表示 640 X480; 如 果 值 为 
4 则 表示 800X480。 参 数 videoSize 默认 值 为 1。 录制 的 视频 帧 速率 为 15 帧 / 秒 。 


recorderStop() 


其 作用 是 停止 录制 多 媒体 。 


startInteractiveVideoRecording (String path) 


其 作用 是 启动 第 三 方 应 用 程序 录制 音 视频 文件 并 存储 到 指定 的 路 径 。 参 数 path 表 
示 存 储 路 径 , 该 路 径 可 以 是 任意 可 以 读 写 的 目录 ,其 形式 可 以 不 是 “/sdcard/ 文 件 名 ”和 
“/sdcard/ 子 目录 /文件 名 ”。 


cameraCapturePicture (String path, Boolean useautofocus) 


其 作用 是 从 镜头 拍摄 图 像 并 存储 到 指定 位 置 .参数 path 表示 存储 位 置 . 参数 
useautofocus 表示 是 否 自动 对 焦 . 值 为 true 表示 自动 对 焦 , 否 则 表示 不 自动 对 焦 。 


cameraInteractiveCapturePicture (String path) 


其 作用 是 启动 第 三 方 拍照 应 用 拍摄 图 像 并 存储 到 指定 位 置 .参数 path 表示 存储 
位 置 。 


11.2.3 多 媒体 录制 应 用 
下 面 是 录音 应 用 范例 .用 户 单 击 开关 按钮 可 实现 录音 和 停止 录音 功能 . 当 开 始 录音 
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时 ,应 用 以 系统 的 当前 日 期 时 间 为 这 段 录 音 命名 ; 当 停止 录音 或 退出 应 用 时 ,应 用 会 把 录 
音 存储 到 “/sdcard” 目 录 中 。 

【 例 11-2〗 《代码 位 置 : \11\Microphone) 
文件 Microphone. php: 


11.2.4 多 媒体 播放 API 


如 果 要 让 应 用 支持 多 媒体 播放 等 功能 .需要 借助 MediaPlayer API 来 实现 ， 
MediaPlayer API 提供 了 播放 ,暂停 .停止 .定位 和 查看 媒体 信息 等 功能 。 下 面 是 SL4A 提 
供 的 多 媒体 方法 。 
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检查 媒体 文件 是 否 在 播放 .如 果 正 在 播放 则 返回 true。 参 数 tag 表示 媒体 标识 符 , 该 参数 
可 由 用 户 来 指定 .参数 可 选 .默认 值 是 default。 


mediaPlay (String url, String tag, Boolean play) 


打开 一 个 媒体 文件 ,如 果 媒体 文件 能 打开 而 且 可 以 播放 则 返回 true。 参 数 url 表示 媒体 
资源 的 URL。 参 数 tag 表示 媒体 标识 符 , 可 选 , 默 认 值 是 default。 参 数 play 是 布尔 值 ， 
表示 是 否 立 即 播放 ,可 选 , 默 认 值 是 true。 


mediaPlayClose (String tag) 


关闭 指定 的 媒体 文件 ,关闭 成 功 则 返回 true。 参 数 tag 表示 媒体 标识 符 , 可 选 , 默 认 值 是 
default。 

mediaPlayInfo(String tag) 
查询 当前 媒体 的 信息 ,查询 成 功 则 返回 媒体 信息 ,媒体 信息 由 固定 的 属性 组 成 ,具体 的 属 
性 和 含义 如 表 11-1 所 示 。 
表 11-1 媒体 信息 属性 














属 性 A : 
tag 媒体 播放 器 标识 符 
loaded 标识 媒体 是 否 已 加 载 , 值 true 表示 已 加 载 ,否则 表示 没有 元 素 被 加 载 
duration 媒体 的 播放 长 度 . 单 位 为 ms 
position 当前 播放 位 置 .单位 为 ms. 位 置 可 由 函数 mediaPlaySeek 控制 





表示 媒体 是 否 正在 播放 , 值 true 表示 正在 播放 ,否则 未 播放 ,媒体 是 否 播放 可 由 函 











加 7 数 mediaPlayPause 和 mediaPlayStart 控制 

url 打开 媒体 文件 的 URL 

looping 媒体 是 否 循环 播放 , 值 true 表示 循环 .可 由 函数 mediaPlaySetLooping 控制 
mediaPlayList() 


获取 当前 已 加 载 媒体 的 列表 .返回 媒体 列表 .列表 项 包含 媒体 的 tag 标识 符 。 


mediaPlayPause(String tag) 


暂停 媒体 文件 的 播放 .暂停 成 功 则 返回 true。 参 数 tag 表示 媒体 标识 符 . 可 选 .默认 值 是 
default 。 


mediaPlaySeek (Integer msec, String tag) 
定位 媒体 播放 位 置 .返回 值 是 新 的 定位 位 置 。 参 数 msec 是 新 位 置 .单位 为 ms., 该 值 应 该 
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在 0 到 媒体 最 大 位 置 之 间 。 参 数 tag 表示 媒体 标识 符 .可 选 .默认 值 是 default。 


mediaPlaySetLooping (Boolean enabled, String tag) 


设置 是 否 循环 播放 媒体 .如 果 成 功 设置 则 返回 true。 参 数 enabled 表示 是 否 循环 播放 , 值 
true 表示 循环 ,参数 可 选 , 默 认 值 是 true。 参 数 tag 表示 媒体 标识 符 ,可 选 ,默认 值 是 
default 。 


mediaPlayStart (String tag[optional, default default]: string identifying resource) 


立即 开始 播放 媒体 文件 :成功 则 返回 true。 参 数 tag 表示 媒体 标识 符 .可 选 ,默认 值 是 


default 。 


11.2.5 多 媒体 播放 器 开发 


例 11-3 是 音乐 播放 器 范例 ,播放 器 会 自动 加 载 /sdcard/sl4a/scripts/media/ 目 录 中 
的 多 媒体 文件 ,用 户 单 击 相应 的 按钮 可 以 进行 开始 播放 、 继 续 播 放 、 暂 停 播 放 、 停 止 播放 媒 
体 和 播放 下 一 首 媒 体 等 操作 。 

【 例 11-3】 (代码 位 置 : \11\mediaPlayer 目录 ) 

文件 Player. xml: 


< ?xml version=“1.0” encoding= utf- 8”?> 

《LinearLayout xmlns:android= “http://schemas. android. com/apk/res/android” 
android:orientation= “vertical” 
android:layout width= “fill parent” android:layout_height= “fill parent” 
android:background=“#ff000000”> 


<TextView 
android:text= “音乐 播放 器 
android:layout_width= “wrap_content” 
android:layout_height=“wrap_content” 
android:textSize= “25px” 
android:id=“"@+id/TextView01” 

/> 

< TextView 
android:text=“ 当 前 媒体 : 
android:layout_width= “wrap_content” 
android:layout_height= “wrap_content” 
android:id= “@+ id/TextView02” /> 

< SeekBar 


android:layout width= “fill parent” 
android:layout _ height=“wrap_content” 


android:layout_alignParentBottom= “true” 
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} 
function file get contents (fileName) { 
var file=new java. io.File (fileName):; 
var reader=new java. io. BufferedReader (new java. io.FileReader (file)); 
var tempString=null; 
var fileString=“”; 
// 一 次 读 入 一 行 ,直到 读 入 null 为 文件 结束 
while ((tempString=reader. readLine()) !=null) { 
fileString=fileString+ tempString ; 
} 
reader. close () ; 
return fileString; 
} 
function dir(filepath) { 
// 功 能 : 读 出 目录 所 有 文件 
var filenames=new Array (); 
var file=new java. io. File (filepath); 
var filelist=file. list(); 
for (var i=0; i<filelist. length; i++) { 
var readfile=new java. io.File(filepath+ “//”+filelist[i]); 
filenames. push (readfile); 
» 
return filenames; 


} 


先 把 多 媒体 文件 复制 到 模拟 器 或 手机 上 的 /sdcard/sl4a/scripts/media/ 目 录 下 ,确保 
多 媒体 文件 是 MP3、AAC、WMA 和 AMR 格式 的 音频 文件 .或 者 是 音频 编码 为 MP3、 
AAC、WMA、AMR 的 AVI.WMV .MP4、3GP、FLYV 视频 文件 。 如 果 格 式 或 音频 编码 不 
正确 将 不 能 播放 媒体 文件 。 程 序 运行 结果 如 图 11-1 所 示 . 单 击 “ 暂 停 按 钮 将 暂停 播放 歌 
曲 , 再 次 单 击 “暂停 ”按钮 会 继续 播放 歌曲 ; 单 击 “ 下 首 ” 按 钮 将 停止 播放 当前 歌曲 将 播放 另 
外 一 首 歌曲 ; 单 击 “ 退 出 "按钮 将 停止 播放 当前 歌曲 。 


音乐 播放 器 





图 11-1 媒体 播放 器 
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11.3 语音 合成 和 语音 识别 API 


11.3.1 什么 是 语音 合成 


语音 合成 又 称 文 语 转换 (Text to Speech,TTS) 技 术 , 能 将 任意 文字 信息 实时 转化 为 
标准 流畅 的 语音 朗读 出 来 ,相当 于 给 机 器 装 上 了 人 工 嘴巴 。 语音 合成 技术 在 自动 控制 、 测 
控 通信 系统 、 办 公 自 动 化 、 信 息 管理 系统 和 智能 机 器 人 等 领域 有 着 宽广 的 应 用 前 景 。 目 前 
各 种 语音 报警 器 .语音 报时 器 .商场 广播 .公车 自动 报 站 、 股 票 信息 查询 .电话 查询 业务 ,以 
及 打印 出 版 过 程 中 的 文本 校对 等 均 已 实现 商品 化 。 

语音 合成 与 传统 的 声音 回放 设备 (系统 ) 有 着 本 质 的 区 别 。 传 统 的 声音 回放 设备 ( 系 
统 ) ,如 磁带 录音 机 ,是 通过 预先 录制 声音 然后 回放 来 实现 “让 机 器 说 话 " 的 。 这 种 方式 无 
论 是 在 内 容 、 存 储 、 传 输 或 者 方便 性 .及 时 性 等 方面 都 存在 很 大 的 限制 。 而 通过 语音 合 
则 可 以 在 任何 时 候 将 任意 文本 转换 成 具有 高 自然 度 的 语音 ,从 而 真正 实现 让 机 器 “ 像 人 一 
样 开口 说 话 ”。 

语音 合成 技术 的 研究 已 有 两 百 多 年 的 历史 ,但 真正 具有 实用 意义 的 近代 语音 合成 技 
术 是 随 着 计算 机 技术 和 数字 信号 处 理 技术 的 发 展 而 发 展 起 来 的 ,主要 是 让 计算 机 能 够 产 
生 高 清晰 度 、 高 自然 度 的 连续 语音 。 在 语音 合成 技术 的 发 展 过 程 中 .早期 的 研究 主要 是 采 
用 参数 合成 方法 .后 来 随 着 计算 机 技术 的 发 展 又 出 现 了 波形 拼接 的 合成 方法 。 

1930 年 ,贝尔 实验 室 开 发 了 声音 编码 器 。 这 是 一 个 用 键盘 操作 的 电子 语音 分 析 器 和 
合成 器 。 第 一 个 基于 计算 机 的 语音 合成 系统 在 20 世纪 50 年 代 后 期 诞生 .第 一 个 完整 的 
TTS 语音 合成 系统 在 1968 年 完成 。 从 那 时 起 至 今 .语音 合成 技术 经 历 了 各 种 各 样 的 技 
术 改 进 。 国 内 的 汉语 语音 合成 研究 起 步 较 晚 ,20 世纪 80 年 代 初 期 .国内 中 文 语音 合成 研 
究 基 本 与 国际 上 的 研究 同步 发 展 。 大 致 也 经 历 了 共振 峰 合成 .LPC 合成 至 应 用 PSOLA 
技术 的 过 程 。 


11.3.2 语音 合成 引擎 


Android 从 1.6 版 本 开始 支持 TTS. 目 前 市 场 上 支持 Android 的 TTS 引擎 产品 很 
多 ,如 Pico .科大 讯 飞 、 捷 通 华声 .InfoTalk、 微 软 和 开源 项 目 eyes-free 的 TTS 产品 。TTS 
产品 可 分 为 两 大 类 : 第 一 类 是 同系 统 接 口 适 配 ;第 二 类 是 与 系统 接口 不 适 配 。 第 一 类 的 
做 法 是 把 TTS 引擎 跟 语 言 包 数据 分 开 ,Pico .科大 讯 飞 和 eyes-free 等 属于 这 一 类 。 这 类 
做 法 的 好 处 是 能 通过 系统 提供 的 接口 去 使 用 TTS 功能 . 易 实现 多 国语 言 拓展 .但 不 足 的 
是 ,设置 语音 朗读 角色 和 设置 语 速 快 慢 就 得 通过 系统 的 接口 去 设置 。 第 二 类 把 引擎 和 语 
言 包 打包 成 一 个 apk 包 . 然 后 安装 完 之 后 .应 用 不 是 通过 系统 提供 的 接口 而 是 通过 自 定义 
的 接口 实现 语音 合成 功能 . 捷 通 华声 等 属于 第 二 类 做 法 。 

Android 内 置 有 Pico 语音 合成 引擎 .其 支持 德 文 .意大利 文法 文 、 英 文 .西班牙 文 等 
多 国语 言 .但 未 支持 中 文 。 因 此 使 用 Android 默认 的 TTS Engine 是 没 法 朗读 中 文 的 。 
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开源 项 目 eyes-free(http://code. google. com/p/eyes-free/) 除 了 提供 Pico 外 .还 把 支持 
其 他 更 多 语言 语音 合成 的 另 一 个 TTS 引擎 eSpeak 也 移植 到 了 Android 平台 ,其 中 就 支 
持 中 文 的 语音 合成 。 因 此 在 安装 了 eyes-free 提供 的 TTS Service Extende 的 apk 后 .就 
可 以 在 程序 中 使 用 eyes-free 提供 的 TTS library. 并 把 TTS Engine 设置 为 不 是 默认 的 
Pico, 而 是 eSpeak, 就 可 以 实现 朗读 中 文 了 。 不 过 经 过 测试 .实际 的 效果 还 是 很 差 的 ,只 
能 说 勉强 可 以 朗读 而 已 。 

科大 讯 飞 是 中 国 最 大 的 智能 语音 技术 提供 商 .在 智能 语音 技术 领域 有 着 长 期 的 研究 
积累 ,并 在 中 文 语音 合成 .语音 识别 .口语 评测 等 多 项 技术 上 拥有 国际 领先 的 成 果 。 科 大 
讯 飞 自 20 世纪 90 年 代 中 期 以 来 .在 历次 的 国内 国外 评测 中 ,各 项 关键 指标 均 名 列 第 一 。 
科大 讯 飞 语音 合成 技术 代表 着 当今 世界 最 高 水 平 , 占 据 语 音 合成 市 场 70% 以 上 份额 。 讯 
飞 语音 TTS 1.0 是 国内 语音 技术 强 者 讯 飞 科技 新 推出 的 一 款 TTS 语音 合成 安 卓 软件 。 
“ 讯 飞 语音 十 1. 1. 1045" 是 讯 飞 语音 最 新 版 的 产品 。 其 支持 中 文 和 英文 两 种 语言 ,中 文 支 
持 普通 话 、 东 北 、 河 南 、 四 川 和 粤语 等 口音 . 除 此 .还 提供 语 速 ,音调 和 音效 (原声 .回声 .机 
器 人 和 阴阳 怪 气 ) 等 相关 设置 ,具有 较 好 的 中 文 语音 效果 。 小 米 等 手机 通常 都 会 预 安装 
“ 讯 飞 语音 十 ”软件 ,用 户 可 以 直接 享用 语音 服务 。 如 果 手 机 没有 预 安装 讯 飞 语音 却 想 享 
用 讯 飞 出 色 的 语音 功能 , 则 需要 自己 动手 安装 讯 飞 语音 软件 。 如 果 安 装 了 讯 飞 语音 软件 
但 不 能 顺利 开启 语音 的 话 , 则 需要 检查 有 没有 下 载 讯 飞 语音 中 文 语音 包 。 讯 飞 语 音 中 文 
语音 包 使 应 用 在 离线 状态 下 便 可 以 使 用 。 以 讯 飞 语音 TTS 1.0 为 例 , 讯 飞 语音 TTS 主 
程序 和 语音 包 可 从 网 站 http://ifly-tts. softonic. cn/android/ 下 载 . 其 安装 如 下 : 

(1) 安装 讯 飞 TTS 主 程序 APK 和 讯 飞 语音 包 APK; 

(2) 选择 “系统 设置 "一 “语音 输入 输出 设置 "一 “文字 转 语音 设置 ">“ 讯 飞 语音 合成 ” 
菜单 命令 ,系统 的 默认 引擎 将 使 用 讯 飞 语音 合成 .引擎 使 用 的 语言 和 语 速 也 可 在 里 面 的 选 
项 进行 设置 。 

11.3.3 语音 合成 API 及 其 应 用 


SL4A 提供 了 两 个 语音 合成 方法 .一 个 用 来 检测 文本 是 否 在 语音 合成 . 另 一 个 用 来 读 
出 文本 。 





ttsSpeak (String message) 


其 作用 是 读 出 参数 message 包含 的 文本 内 容 . 文 本 内 容 可 以 是 中 英文 字符 串 。 


ttsIsSpeaking () 


其 作用 是 检测 语音 合成 是 否 正在 进行 .正在 合成 则 返回 true。 系 统 在 使 用 TTS 时 . 
新 的 语音 任务 应 该 要 等 待 。 

例 11-4 是 语音 合成 API 范例 .程序 运行 后 将 读 出 “大 家 好 ”。 程 序 运行 前 需要 确保 已 
安装 科大 讯 飞 语音 应 用 和 语音 库 。 如 果 使 用 的 是 Pico 引擎 则 不 能 发 音 。 

【 例 11-4】 (代码 位 置 : \11\testTTS. js) 
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load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js“) ; 
var droid=new Android(); 

droid. ttsSpeak (“大 家 好 “); 

droid. eventWait (3000) ; 


手机 原先 是 为 视力 正常 的 人 设计 的 .没有 充分 考虑 到 一 些 视力 较 弱 或 盲人 的 需要 。 
如 果 应 用 在 来 电 显示 .阅读 短 消息 和 闹钟 提示 等 功能 中 加 入 语音 合成 则 用 来 帮助 弱视 人 
士 解决 大 部 分 的 手机 应 用 困难 ,相信 这 样 也 会 吸引 广大 普通 用 户 的 眼球 。 例 11-5 是 短 消 
息 朗 读 范例 ,范例 会 以 列表 形式 显示 所 有 短 消息 ,用 户 单 击 短 消息 后 系统 会 把 短 消息 内 容 
朗读 出 来 。 

【 例 11-5】 (代码 位 置 : \11\shortmsg) 

文件 mylayout. xml: 





< 9xm] version=”1.0” encoding= “utf- 8”?> 
<LinearLayout 
android:id=“@+id/LinearLayout01” 
android:layout_width= “fill_parent” 
android:layout height= “fill parent” 
xmlns:android= “http://schemas. android. com/apk/res/android” 
android:background=“#ff000000” > 
<ListView android:layout width=“wrap_content” 
android:layout height= “wrap_content” 
android:id=“@+ id/ListView01” 
android:drawSelectorOnTop= “false” /> 
< /LinearLayout> 


文件 shortmsg. js: 





load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”. 
var droid= new Android(); 


speakMessage (droid); 


function speakMessage (droid) 
{ // 功 能 : 朗读 短 消息 
var ret= droid. smsGetMessagelds (false) ; 
var sms=new Array(); 
for( var keyy in ret ) 
{ 
var tmp= droid. smsGetMessageById (ret [keyy]): 
var body= tmp. body ; 
var address= tmp. address; 
// 格 式 化 短 消息 
var contentsms=“ 短 消息 内 容 :“+body+ ”\n 发 信号 码 : “+¥address; 
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程序 运行 结果 如 图 11-2 所 示 . 用 户 单 击 短 消息 后 系统 将 朗读 该 条 短 消息 .直到 朗读 
结束 程序 才 结 束 退 出 。 


11.3.4 什么 是 语音 识别 


语音 识别 技术 也 被 称 为 自动 语音 识别 (Automatic Speech Recognition. ASR), 其 目 
标 是 将 人 类 语音 中 的 词汇 内 容 转换 为 计算 机 可 读 的 输入 ,例如 按键 .二 进 制 编码 或 者 字符 
序列 .或 者 说 .其 要 解决 的 问题 是 让 计算 机 能 够 “ 听 懂 ”人 类 的 语音 .将 语音 中 包含 的 文字 
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图 11-2 朗读 短信 


信息 “提取 ”出 来 。 

语音 识别 技术 是 非常 重要 的 人 机 交互 技术 ,有 着 非常 广泛 的 应 用 领域 和 市 场 前 景 , 常 
见 的 语音 识别 技术 的 应 用 包括 语音 拨号 .语音 导航 、 室 内 设备 控制 .语音 文档 检索 和 数据 
录入 等 。 随 着 语音 技术 的 发 展 , 它 将 为 网 络 会 议 .商业 管 理 . 医 药 卫 生 ,教育 培训 等 领域 提 
供 便利 。 

早 在 计算 机 发 明之 前 ,自动 语音 识别 的 设想 就 已 经 被 提 上 了 议事 日 程 ,早期 的 声 码 器 
可 被 视 作 语音 识别 及 合成 的 雏形 。 而 20 世纪 20 年 代 生 产 的 Radio Rex 玩具 狗 可 能 是 最 
早 的 语音 识别 器 , 当 这 只 狗 的 名 字 被 呼唤 的 时 候 , 它 能 够 从 底座 上 弹出 来 。1952 年 贝尔 
研究 所 Davis 等 人 研究 成 功 了 世界 上 第 一 个 能 识别 10 个 英文 数字 发 音 的 实验 系统 。 
1960 年 英国 的 Denes 等 人 研究 成 功 了 第 一 个 计算 机 语音 识别 系统 。 大 规模 的 语音 识别 
研究 是 在 20 世纪 70 年 代 以 后 ,在 小 词汇 量 ,孤立 词 的 识别 方面 取得 了 实质 性 的 进展 。 进 
入 20 世纪 80 年 代 以 后 .研究 的 重点 逐渐 转向 大 词汇 量 、 非 特定 人 连续 语音 识别 。 中 国 的 
语音 识别 研究 起 始 于 1958 年 .由 中 国 科 学 院 声 学 所 利用 电子 管 电路 识别 10 个 元 音 。 直 
至 1973 年 才 由 中 国 科学 院 声学 所 开始 计算 机 语音 识别 。 由 于 当时 条 件 的 限制 ,中 国 的 语 
音 识别 研究 工作 一 直 处 于 缓慢 发 展 的 阶段 。 进 入 20 世纪 80 年 代 以 后 , 随 着 计算 机 应 用 
技术 在 中 国 逐 渐 普 及 以 及 数字 信号 技术 的 进一步 发 展 .国内 许多 单位 具备 了 研究 语音 
术 的 基本 条 件 。1986 年 3 月 中 国 高 科技 发 展 计划 (863 计划 ) 启 动 .语音 识别 作为 智能 计 
算 机 系统 研究 的 一 个 重要 组 成 部 分 而 被 专门 列 为 研究 课题 。 在 863 计划 的 支持 下 ,中 国 
开始 了 有 组 织 的 语音 识别 技术 的 研究 .并 决定 了 每 隔 两 年 召开 一 次 语音 识别 的 专题 会 议 。 
从 此 中 国 的 语音 识别 技术 进入 了 一 个 前 所 未 有 的 发 展 阶段 。 


11.3.5 语音 识别 引擎 


语音 识别 技术 是 在 Android1. 5 中 才 加 入 的 .借助 语音 识别 引擎 可 以 识别 用 户 的 语音 
输入 。 类 似 小 米 手 机 中 的 语音 助手 软件 .有 的 Android 应 用 会 集成 语音 识别 功能 。 由 于 
语音 识别 引擎 要 求 较 高 .因此 一 般 的 开发 者 是 不 可 能 选择 自己 开发 语音 识别 引擎 的 。 把 
一 个 成 熟 的 语音 识别 引擎 集成 到 Android 应 用 中 对 大 多 数 开发 人 员 来 说 是 比较 明智 的 做 
法 。 通 常 可 以 将 集成 语音 识别 引擎 划分 为 两 种 做 法 .一 种 做 法 是 开发 者 不 需要 另外 开发 
识别 交互 界面 :而 是 在 应 用 中 直接 调用 语音 识别 引擎 为 开发 者 设计 好 的 语音 识别 对 话 框 ， 
用 户 通过 这 个 对 话 框 输入 语音 .语音 识别 引擎 识别 出 语音 内 容 后 把 语音 文本 回 传 给 应 用 ; 
另 一 种 做 法 是 开发 人 员 自 己 开发 一 个 语音 识别 交互 界面 录 下 用 户 的 语音 .把 语音 提交 给 
语音 识别 引擎 处 理 获取 语音 文本 内 容 。 前 一 种 方法 相对 后 一 种 方法 更 简单 .本 文 讲述 前 
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一 种 开发 方法 。 

目前 国内 较为 著名 的 两 家 提供 语音 识别 技术 的 厂商 分 别 是 科大 讯 飞 和 百度 ,并 且 两 
家 厂商 都 开放 了 相应 的 API 接口 ,通过 API 接口 开发 人 员 可 以 轻松 地 在 自己 的 应 用 中 实 
现 语音 识别 。 百 度 语音 识别 引擎 的 特点 是 完全 永久 免费 、 全 平台 REST API、 自 动 识别 离 
线 在 线 模式 、 深 度 语 义 解析 、 场 景 识别 定制 .自行 上 传 词 库 训 练 专属 识别 模型 。 科 大 讯 飞 
语音 识别 产品 支持 Android\iOS 和 Windows Phone 等 主流 系统 ,其 语音 云 拥 有 国际 领先 
的 连续 语音 识别 技术 ,听写 结果 快速 反馈 .动态 实时 修正 .识别 准确 率 超过 95%% ,实现 快 
速 精准 的 语音 听写 ;语音 输入 速度 达 180 字 / 分 :识别 结果 响应 时 间 低 于 500ms ,无 论 是 识 
别 实时 率 还 是 响应 时 间 , 系统 运行 效率 都 让 信息 沟通 变 得 无 比 顺畅 ;支持 中 英 粤 藏 维 等 5 
个 语种 . 川 移 和 东北 等 方言 。 同 时 .还 提供 多 个 满足 条 件 的 识别 结果 .供用 户 进行 二 次 选 
择 , 实 现 开发 更 加 灵活 、 更 加 人 性 化 的 业务 流程 ;基于 用 户 通话 的 语音 特征 ,建立 个 性 化 词 
条 定制 的 语言 模型 ,调整 识别 参数 .持续 优化 识别 效果 .提高 用 户 的 个 性 化 词 条 识别 准确 
率 。 现 超过 70% 的 语音 开发 者 会 选择 科大 讯 飞 语音 识别 产品 。 


11.3.6 语音 识别 API 及 其 应 用 
recognizeSpeech (String prompt, String language, String languageModel) 


其 作用 是 识别 用 户 的 讲话 内 容 并 返回 语音 识别 的 文本 字符 串 , 如 果 不 能 识别 则 返回 
空 字 符 串 。 参 数 prompt 表示 请 求 用 户 讲话 时 所 显示 的 提醒 文本 ,参数 language 表示 识 
别 语言 ,如 果 不 指定 此 参数 则 选用 系统 默认 配置 好 的 语言 识别 用 户 的 语音 内 容 。 如 果 选 
择 美 国 英 语 , 则 值 可 设置 为 en-US。 参 数 languageModel 表示 语言 模式 。 

下 面 是 语音 识别 实例 ,该 实例 会 先 要 求 用 户 输入 语音 .然后 通过 语音 引擎 识别 出 语音 
中 的 文字 ,最 后 把 文字 显示 出 来 和 用 语音 合成 读 出 来 。 为 顺利 运行 此 程序 ,需要 先 安装 谷 
歌 语 音 百度 语音 和 讯 飞 语音 等 语音 软件 ;然后 在 手机 设置 中 把 语音 识别 和 语音 合成 设置 
成 实际 安装 的 语音 软件 ,最 后 还 需要 打开 WiFi, 因 为 语音 软件 通常 都 需要 借助 语音 云 。 

【 例 11-6】 (代码 位 置 ; \11\recognizeSpeech. js) 


load(”/sdcard/com. googlecode. rhinoforandroid/extras/rhino/android. js”); 
var droid= new Android(); 
var ret= droid. recognizeSpeech () ; 
if ( !droid. ttsIsSpeaking() !=true ) 
droid. ttsSpeak (ret); 
droid. makeToast (ret) ; 
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Android 移动 产品 的 实现 方式 主要 有 Native App、Web App 和 Hybrid App 三 种 。 
Native App 也 称 原生 态 应 用 ., 它 通常 是 指 采 用 Java 或 C/C++ 语言 开发 的 Android 应 用 。 
这 种 应 用 程序 能 直接 使 用 Android 系统 提供 的 网 络 、 传 感 器 、 音 视频 .电话 和 定位 等 原生 
态 服务 . 除 此 . 它 还 可 以 直接 访问 硬件 。Web App 又 叫 Web 应 用 ,这 种 Web 应 用 完全 用 
HTML5 ,JavaScript 和 CSS 等 Web 技术 开发 ,其 运行 在 移动 设备 的 浏览 器 中 。 这 种 应 用 
可 以 跨越 Windows、Android 和 iOS 等 系统 ,但 无 法 使 用 Android 系统 提供 的 原生 态 服 
务 , 无 法 充分 发 挥手 机 的 移动 优势 。Hybrid App 又 叫 混 合 应 用 , 它 是 指 采 用 Native App 
和 Web App 开发 技术 开发 的 应 用 。 在 混合 应 用 中 .开发 者 既 可 以 使 用 Web 技术 快速 开 
发 出 应 用 程序 UI 界面 .又 可 以 把 Android 的 电话 、 短 信和 摄像 等 原生 态 服务 整合 到 应 用 
中 。 它 兼 具 *Native App 良好 用 户 交 互 体验 的 优势 "和 “Web App 跨 平 台 开 发 的 优势 ”。 
总 之 ,Native App 方法 在 性 能 和 设备 访问 能 力 方面 表现 出 色 . 但 存在 应 用 开发 和 应 用 更 
新 困难 等 问题 ;Web App 方法 在 软件 维护 等 方面 存在 优势 .但 设备 访问 能 力 偏 低 ,很 难 提 
供出 色 的 用 户 体 验 ;Hybrid App 提供 了 折 中 方案 ,具有 两 者 的 优势 。 表 12-1 列 出 了 三 种 
方法 在 跨 平 台 性 和 设备 能 力 等 方面 的 优 劣 性 。 


表 12-1 三 种 开发 方法 优 劣势 




















开发 方法 Native App Web App Hybrid App 

开发 语言 Java. C/C++ HTML5 十 CSS 十 JavaScript | HTML5 十 CSS 十 JavaScript 等 脚本 
跨 平台 性 低 高 中 

设备 能 力 高 低 中 

开发 难度 高 低 中 

应 用 体验 好 差 好 

往 后 兼容 差 较 好 好 











基于 对 话 框 和 Android Widget 的 Android 应 用 属于 Native App 开发 模式 .这 种 界 
面 要 么 只 可 以 实现 简单 的 对 话 框 界面 .要 么 存在 界面 难以 更 新 等 问题 。 能 不 能 复 用 已 有 
的 成 熟 技术 实现 符合 手机 风格 的 界面 .从 而 解决 界面 更 新 难 和 开发 难度 高 等 问题 呢 ? 
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Web App 和 Hybrid APP 方法 就 是 符合 这 样 要 求 的 方法 。 这 两 种 方法 的 共性 是 都 使 用 
HTML 设计 和 实现 手机 应 用 界面 。 这 两 种 方法 使 用 一 个 以 WebKit 为 核心 的 浏览 器 来 
显示 页 面 ,页 面 可 以 使 用 HTML、JavaScript 和 CSS 等 语言 编写 .页面 可 以 是 驻 留 在 
Web 服务 器 上 的 页 面 ,也 可 能 是 一 组 存储 在 手机 本 地 的 HTML、JavaScript、CSS 和 媒体 
文件 。 通 过 HTML 和 CSS 可 以 很 快 设 计 出 符合 各 类 要 求 的 手机 界面 .通过 JavaScript 
可 以 让 界面 和 Web 服务 器 或 手机 操作 系统 进行 通信 ,如 果 是 Web App 就 只 能 和 Web 
服务 器 进行 交换 数据 ,如 果 是 Hybrid App 则 可 以 同 Web 服务 器 和 手机 操作 系统 交换 
数据 。 


12.2 HTML 基 础 


2014 年 10 月 29 日 :万维网 联盟 宣布 .HTML5 标准 规范 经 过 近 八 年 的 艰辛 努力 终 
于 最 终 制 定 完 成 。HTML5 将 会 取代 1999 年 制定 的 HTML4.01、 XHTML 1.0 标准 ,以 
期 能 在 互联 网 应 用 迅速 发 展 的 时 候 . 使 网 络 标准 达到 符合 当代 的 网 络 需求 ,为 桌面 和 移动 
平台 带 来 无 缝 衔 接 的 丰富 内 容 。 和 普遍 使 用 的 HTML4 相 比 ,HTML5 提供 了 很 多 新 的 
特性 ,比如 ,视频 播放 .Web 本 地 存储 .地 理 定位 .应 用 缓存 和 Canvas 等 。 这 些 新 特性 特 
别 适用 于 移动 应 用 开发 ,例如 ,可 以 通过 HTML5 的 地 理 定位 特性 定位 移动 设备 地 理 位 
置 。 最 新 版 本 的 Internet Explorer、Safari、Chrome、Firefox 以 及 Opera 支持 某 些 
HTML5 特性 。 基 于 SL4A 的 Android 脚本 需要 借助 基于 WebKit 的 WebView 浏览 器 
组 件 才能 使 用 HTML5 特性 。 下 面 仅 讲述 WebView 所 支持 的 HTML5 特性 。 

在 HTML5 页 面 中 ,播放 视频 (video) 与 音频 (audio) 不 再 是 困难 的 事情 。video 元 素 
提供 了 播放 ,暂停 和 音量 控件 来 控制 视频 。 同 时 video 元 素 也 提供 了 width 和 height 属 
性 控制 视频 的 尺寸 。HTML5 规定 了 在 网 页 上 嵌 入 音频 元 素 的 标准 ,即使 用 audio 元 素 。 
HTML5 提供 了 浏览 器 端的 数据 库 支持 ,人 允许 直接 通 JavaScript 的 API 在 浏览 器 端 创建 
本 地 数据 库 .而 且 支 持 标 准 的 SQL, 这 让 浏览 器 端的 应 用 可 以 更 加 方便 地 操作 结构 化 
数据 。 

HTML5 允许 使 用 JavaScript 的 API 绘制 图 形 。 尽 管 本 书 的 焦点 是 Android 脚本 而 
不 是 HTML5, 但 探讨 使 用 HTML5 绘图 还 是 很 有 必要 的 .因为 SL4A 没有 为 Android 肢 
本 提供 一 个 统一 的 绘图 框架 .而 HTML5 却 提供 了 这 样 一 个 统一 的 绘图 框架 。 

HTML5 绘图 的 核心 是 canvas 元 素 。canvas 元 素 是 HTML5 提供 的 新 元 素 . 其 作用 
是 为 绘图 者 提供 画布 .尽管 可 以 把 图 形 绘 制 在 画布 上 .但 画布 本 身 不 提供 绘图 功能 。 所 有 
的 图 形 要 绘制 在 画布 中 .还 需要 画布 的 上 下 文 context。 上 下 文 context 是 提供 绘图 功能 
的 一 个 对 象 . 每 个 canvas 元 素 都 拥有 这 样 一 个 对 象 .其 提供 了 所 有 的 绘图 方法 和 属性 。 
JavaScript 脚本 可 以 调用 设置 context 对 象 中 的 绘 法 和 设置 context 对 象 中 的 绘图 属 
性 实现 绘图 功能 。canvas 画布 不 仅 提供 简单 的 二 维 矢量 绘图 方法 .也 提供 三 维 绘图 方 
法 。context 采用 笛 卡 儿 值 坐标 系 .canvas 画布 的 左上 角 为 原点 ,从 原点 往 右 为 X 轴 的 正 
向 . 往 下 为 Y 轴 的 正 向 。 

canvas 绘图 步骤 : 先 创建 HTML 页 面 .设置 canvas 画布 ;其 次 通过 JavaScript 获取 
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canvas 画布 的 上 下 文 context; 最 后 通过 JavaScript 调用 上 下 文 context 中 的 方法 绘制 图 
形 。 使 用 context 上 下 文 绘制 图 形 前 应 该 要 指明 绘图 填充 方式 、 绘 图 样式 和 绘图 线 
宽 。context 提供 绘 线 (stroke) 和 填充 (fill) 两 种 填充 方式 。 填充 指 的 是 填 满 图 形 内 
部 ; 绘 线 是 指 不 填 满 图 形 的 内 部 .只 绘制 图 形 的 外 框 。 绘 图 样式 是 指 绘图 的 颜色 、 透 
明度 和 渐变 等 ,样式 可 用 十 六 进 制 值 表示 ,如 “站 ffto000” 表 示 红 色 ,rgba(0 一 255,0 一 
255,0 一 255.0 一 1 透明 度 值 ) 表 示 带 有 透明 度 的 颜色 。 线 宽 是 指 直线 的 宽度 ,可 通 
过 属性 lineWidth 设置 。 

HTML5 支持 绘制 直线 、 弧 线 、 曲 线 、 方 形 和 国 形 等 基本 图 形 。 在 图 形变 形 方面 ,支持 
图 形 平移 .旋转 和 缩放 。HTML5 支持 图 形 组 合 操 作 , 图 形 组 合 是 指 将 一 个 源 图 形 ( 新 的 
图 形 ) 重 又 绘制 在 另 一 个 目标 图 形 ( 已 有 的 图 形 ) 。 源 (目标 ) 图 形 可 以 覆盖 目标 ( 源 ) 图 形 ， 
或 者 重合 部 分 仅 显 示 源 (目标 ) 图 .或 者 仅 显 示 源 (目标 ) 图 非 重合 部 分 而 不 显示 源 ( 目 标 ) 
图 重 又 部 分 .这 样 的 图 形 组 合 数量 达 11 种 。HTML5 支持 绘制 文字 .包括 字体 、 颜 色 和 对 
齐 等 设置 。HTML5 不 仅 支 持 图 形 处 理 , 还 支持 图 像 处 理 , 包 括 图 像 平 铺 、 图 像 裁剪 .像素 
处 理 等 操作 。 
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CSS 也 称 层 又 样式 表 (Cascading Style Sheet) 。CSS 是 一 种 标记 语言 , 它 不 需要 编 
译 , 可 以 直接 由 浏览 器 解释 执行 。 在 HTML 页 面 中 采用 CSS, 可 以 有 效 地 对 页 面 的 布 
局 .字体 .颜色 ,背景 和 其 他 效果 实现 更 加 精确 的 控制 。 和 用 JavaScript 模拟 这 些 效果 相 
比 ,CSS 不 仅 降低 了 复杂 度 , 变 得 易 维护 .在 性 能 上 也 是 突飞猛进 。 采 用 CSS 十 DIV 进行 
网 页 重 构 相 对 传统 的 表格 构建 网 页 布局 具有 以 下 三 个 显著 优势 。 

(1) 表现 和 内 容 相 分 离 。 从 HTML 页 面 将 设计 部 分 剥离 出 来 放 在 CSS 文件 ， 
HTML 文件 是 内 容 .CSS 文件 是 表现 。 

(2) 提高 页 面 浏览 速度 。 对 于 同一 个 页 面 视觉 效果 .采用 CSS 十 DIV 重 构 的 页 面容 
量 要 比 传统 表格 编码 的 页 面 文件 容量 小 得 多 ,浏览 器 可 省 掉 编 译 大 量 宛 长 的 HTML 标 
签 所 消耗 的 时 间 。 

(3) 易于 维护 和 改版 。 只 要 简单 地 修改 CSS 文件 就 可 以 重新 设计 整个 网 站 的 页 面 。 

1996 年 12 月 W3C 推出 了 CSS 规范 的 第 一 个 版 本 。1999 年 W3C 发 布 了 CSS 的 第 
二 个 版 本 即 CSS2. 0。2001 年 5 月 W3C 开始 进行 CSS3 标准 的 制定 。 

CSS1.0 较为 全 面 地 规定 了 文档 的 显示 样式 .其 大 致 可 分 为 选择 器 样式 属性 、 伪 类 / 
对 象 几 个 大 的 部 分 。 选 择 器 可 分 为 派生 选择 器 .ID 选择 器 和 类 选择 器 .选择 器 声明 了 “ 样 
式 " 的 作用 对 象 .也 就 是 样式 在 哪些 HTML 元 素 产生 效果 。 样 式 属性 主要 包括 Font 字 
体 、Text 文本 、Background 背景 .Position 定位 .Dimensions 尺寸 .Layout 布局 .Margins 
外 边框 .Border 边框 .Padding 内 边框 、List 列表 、Table 表格 和 Scrollbar 滚动 条 等 .样式 
属性 可 用 来 定义 HTML 元 素 的 样式 。 伪 类 可 以 根据 HTML 元 素 的 当前 状态 ,动态 指定 
HTML 元 素 的 样式 。 在 CSS1. 0 中 主要 定义 了 针对 锚 对 象 a 的 link、 hover、active、 
visited 和 针对 节点 的 first-letter,first-child ,first-line 几 个 伪 类 属性 。 
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CSS2 规范 是 基于 CSS1 设计 的 .其 包含 CSS1 所 有 的 功能 .并 扩充 和 改进 了 很 多 更 加 
强大 的 属性 。CSS2 提供 了 更 多 强大 的 选择 器 来 定位 HTML 元 素 .例如 ,BBB[text 一 
"xyz"] (color:blue}) 表示 包含 text 属性 值 为 “xyz” 的 BBB 标签 。CSS2 扩充 了 新 的 样式 
属性 .功能 更 强大 。 例 如 .CSS2 进一步 增强 了 Pisition 定位 功能 .增加 了 relative 和 
absolute 定位 功能 。 在 CSS2 中 不 但 增加 了 :focus :first-child、 :lang 等 几 个 新 的 伪 类 . 同 
时 还 扩充 了 伪 类 的 使 用 范围 。 使 得 伪 类 不 但 可 以 和 原来 一 样 应 用 于 a 锚 标 签 .还 可 以 应 
用 到 一 个 类 和 标签 上 .例如 . link:hover 和 myClass: hover。 

CSS3 是 CSS 技术 的 升级 版 本 .CSS3 是 最 新 的 版 本 ,样式 效果 方面 CSS2 是 比 不 了 
的 ,比如 定义 圆 角 .背景 颜色 渐变 .背景 图 片 大 小 控制 和 定义 多 个 背景 图 片 等 ,这 些 是 
CSS2 没有 的 效果 。CSS3 规范 一 个 新 的 特点 是 规范 被 分 为 若干 个 相互 独立 的 模块 。 
方面 分 成 若干 较 小 的 模块 较 利于 规范 及 时 更 新 和 发 布 .及 时 调整 模块 的 内 容 。 另 外 一 方 
面 ,由 于 受 支持 设备 和 浏览 器 厂商 的 限制 .设备 或 者 厂商 可 以 有 选择 地 支持 一 部 分 模块 ， 
支持 CSS3 的 一 个 子 集 。 这 样 将 有 利于 CSS3 的 推广 。 相 信 这 对 以 前 CSS 支持 混乱 的 局 
面 将 会 有 所 改观 。 


12.4 HTML 和 JavaScript 通 信 


如 果 建 立 的 Android 应 用 程序 只 是 向 用 户 展示 一 些 静 态 的 信息 ,这 些 信息 可 能 只 包 
括 文本 ,那么 使 用 HTML 文件 实现 界面 是 一 种 简单 可 行 的 方法 。HTML 文件 可 以 由 程 
序 运行 过 程 自动 创建 ,也 可 以 使 用 一 些 HTML 编辑 工具 在 程序 运行 前 设计 和 创建 。 如 
果 要 图 文 并 茂 地 向 用 户 展示 界面 .可 以 在 HTML 文件 中 加 入 CSS 使 界面 具有 更 好 的 用 
户 体验 性 。 这 和 传统 的 Web 应 用 界面 设计 方法 是 相同 的 ,所 不 同 的 是 ,使 用 HTML 设计 
Android 手机 应 用 应 该 要 符合 手机 的 风格 而 不 是 使 用 Web 风格 来 设计 手机 应 用 .例如 ， 
界面 中 尽 可 能 不 要 出 现 动画 效果 ,因为 手机 屏幕 偏 小 ,动画 效果 会 覆盖 掉 界 面 中 所 包含 的 
主要 内 容 。 

如 果 要 让 使 用 HTML 设计 的 Android 应 用 具有 互动 性 , 则 界面 应 该 要 能 和 Android 
系统 交换 数据 或 者 说 请 求 服务 。 通 过 SL4A 基于 事件 循环 使 用 WebView 可 以 解决 
HTML 和 脚本 通信 交换 数据 问题 。 这 种 事件 循环 同 原生 态 图 形 应 用 和 Web 应 用 的 通信 
是 不 同 的 。 例 如 .事件 循环 不 需要 管理 帧 速率 和 缓冲 区 大 小 .不 需要 像 Ajax 和 
websocket 那样 存在 连接 管理 等 问题 。 这 种 事件 循环 只 需要 向 用 户 接 口 发 送 和 接收 事件 
即 可 。 

为 了 不 混淆 提高 可 理解 度 .本 节 不 使 用 JavaScript 和 HTML 页 面 中 的 JavaScript 讲 
述 通信 :而 使 用 PHP 和 HTML 页 面 中 的 JavaScript 讲述 通信 。SL4A 为 Web 页 面 和 
PHP 脚本 通信 提供 了 支持 。 通 信 可 以 是 单 向 的 .也 可 以 是 双向 的 。 单 向 指 的 是 PHP 
(HTML 页 面 中 的 JavaScript) 向 HTML 页 面 中 的 JavaScript(PHP) 发 送 消息 .双向 指 的 
是 双方 彼此 发 送 消息 。 两 者 发 送 消息 的 过 程 是 相同 的 .都 是 创建 Android 对 象 .通过 这 个 
对 象 调用 SL4A 事件 发 送 方法 发 送 事件 交换 数据 。 
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但 PHP 和 HTML 页 面 中 的 JavaScript 响应 事件 的 模型 是 不 同 的 。PHP 通过 事件 
轮 询 模型 响应 事件 ,PHP 会 每 隔 一 个 时 间 片 就 监听 等 待 指定 事件 ,如 果 指 定 事件 发 生 就 
处 理事 件 , 如 果 指 定 事件 超时 就 会 处 理 其 他 事务 ,之 后 再 继续 监听 指定 事件 。 如 果 
HTML 页 面 中 的 JavaScript 使 用 事件 轮 询 模 型 处 理 指定 事件 ,那么 整个 页 面 势必 存在 管 
理 困 难 等 问题 ,甚至 不 能 或 不 及 时 响应 事件 。 通 过 回调 函数 可 以 及 时 处 理事 件 , 有 效 降 低 
管理 难度 。 可 以 这 样 理解 JavaScript 中 的 回调 函数 : 函数 A 作为 参数 传递 到 另 一 个 函数 
B 中 , 当 特 定 条 件 发 生 了 .函数 A 就 会 被 执行 .函数 A 叫 做 回调 函数 。 如 果 函 数 A 没有 
名 称 , 就 叫做 匿名 回调 函数 。 回 调 函 数 不 是 由 该 函数 的 实现 方 直 接 调用 ,而 是 在 特定 的 事 
件 或 条 件 发 生 时 由 另外 的 一 方 调用 的 .用 于 对 该 事件 或 条 件 进 行 响 应 。HTML 页 面 中 的 
JavaScript 要 使 用 回调 函数 处 理事 件 , 需 要 注册 回调 函数 。 下面 是 回调 函数 注册 方法 
定义 。 

registerCallback (String eventName, function(e) {函数 语句 } ) 


参数 eventName 表示 事件 名 称 ,参数 function(e) {函数 语句 ) 是 回调 函数 式 ,回调 函 
数 有 且 仅 有 一 个 参数 e, 参 数 是 事件 所 附加 的 数据 。 该 方法 的 作用 是 当 指定 的 事件 
eventName 发 生 时 ,就 执行 回调 函数 。 

下 面 是 HTML 页 面 中 的 JavaScript 发 送 消息 和 PHP 响应 消息 的 通信 实例 。 在 例 
中 ,用 户 先 可 以 先 在 文本 框 中 输入 文字 内 容 ,然后 再 单 击 " 点 读 ” 按 钮 ,最 后 手机 会 读 出 用 
户 输入 的 文字 内 容 。 实 例 由 文件 speech. php 和 speech. html 组 成 ,文件 speech. php 的 作 
用 是 启动 speech. html 显示 HTML 界面 .以 及 监听 事件 say 和 读 出 事件 所 携带 的 文字 内 
容 。 文件 speech. html 的 作用 是 显示 HTML 界面 .让 用 户 输入 文字 ,以 及 把 文字 内 容 封 
装 到 事件 say 中 传递 给 文件 speech. php 处 理 。 如 果 手 机 未 配置 讯 飞 音 语 等 支持 中 文 的 
语音 引擎 ,那么 用 户 只 能 输入 英文 内 容 。 

【 例 12-1】 (代码 位 置 ; \12\htmlBattery. php) 

文件 speech. php: 


< ?php 
require_once(”Android. php”); 
¥ droid=new Android(); 
¥droid- > webViewShow(’ file:///sdcard/sl4a/scripts/speech. html’ ); 
¥ret=¥ droid- > eventWait () ; 
¥ret=¥ret[’ result’ ]; 
while ( (¥ ret!=null ) && (¥ret- >namel= “say“) ) 
{ 
¥ret=¥ droid- > eventWait (); 
¥ret=¥ ret[’ result’ ]; 
¥ret=¥ droid- > ttsSpeak (¥ ret—- > data); 
> 
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文件 speech. html: 


<html> 
《<head> 
<meta http-equiv= “content- type” content= ”text/html; charset=utf-8” /> 
《title> JavaScript 和 PHP 通信 测试 < /title> 
《Script type= “text/javascript”> 
var droid= new Android() ; 
var speak= function() { 
var content= document. getElementById(“say“). value; 
droid. eventPost (“say”, content, true) ; 
} 
</script> 
</head> 
《body> 
<form onsubmit= ”speak () ; return false; ”> 
“label1> 你 想 说 些 什么 呢 ?< /label> 
“input type= “text” id=“say” /> 
《<input type=“submit”value=“ 点 读 ” /> 
< /form> 
《</body> 
</html> 


下 面 是 双向 通信 范例 。 例 中 由 voice. htm 和 voice. php 组 成 。voice. htm 是 用 户 界 
面 , 用 户 界面 由 文本 框 .说 话 按钮 和 退出 按钮 组 成 ,用 户 可 以 在 文本 框 中 输入 文字 , 当 按 回 
车 键 时 会 用 红色 显示 文字 ,文字 大 小 是 随机 变化 的 ;用 户 单 击 说 话 按钮 会 启动 语音 识别 ， 
识别 出 的 文字 会 用 红色 显示 出 来 ,文字 大 小 是 随机 变化 的 ; 单 击 退 出 按钮 会 结束 应 用 程 
序 。voice. htm 通过 事件 line 把 用 户 输入 的 文字 发 送 给 voice. php 处 理 ,通过 事件 
recognizeSpeech 向 voice. php 请 求 启 动 语音 识别 。voice. htm 设置 了 回调 函数 , 当 事 件 
stdout 产生 时 会 自动 执行 回调 函数 ,此 回调 函数 的 作用 是 显示 voice. php 处 理 后 的 文字 内 
容 。voice. php 的 作用 是 接收 文件 voice. htm 发 送 过 来 的 文字 或 接受 voice. htm 发 送 过 来 的 
命令 启动 语音 识别 接收 文字 ,并 设置 字体 为 红色 和 随机 设置 字体 大 小 。voice. Php 通过 事件 
stdout 把 处 理 后 的 文字 传递 给 voice. htm 页 面 显示 出 来 。 12-1 是 范例 的 运行 结果 。 

【 例 12-2】 (代码 位 置 : \12\webview\voice) 

文件 voice. htm: 


< IDOCTYPE HTML> 
<html> 
< head> 
<meta name= “viewport” id= “viewport” 
content= “width= device- width，target- densitydpi= device- dpi, 
initial- scale=1.0, maximum- scale=1.0, minimum- scale=1.0” 


/> 
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文件 voice. php: 
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¥1ine=¥ event- > data; 
¥ size= rand(5, 15) ; 
Youtput= "<font size=’¥ size’ color=’red’>“.¥ 1ine.’ /font>’:; 
¥droid- > eventPost( stdout’, ¥ output); 
} 
if (¥event->name==’ recognizeSpeech’” ) 
{ 
¥ret=¥ droid- > recognizeSpeech(); 
¥1ine=¥ret[”result”]; 
¥ size=rand (5, 15) ; 
¥output=“<font size=’¥ size’” color=’red’ > “.¥1ine.’</font>’; 
¥droid- > eventPost(’ stdout’, ¥ output); 
} 
} 
?> 





SL4A Webview 双 向 通信 实例 (PHP 和 JavaScript) 
在 文本 相国 革 昌 示 文本 ,单机 说 话 按 租 明示 文本 


I 单 击 说 话 | 














图 12-1 双向 通信 范例 


12.5 HTML 实现 And1oid GUI 范 例 
下 面 是 电池 状态 测试 实例 。 本 例 展 示 了 如 何 使 用 HTML 文件 实现 Android 应 用 界 


面 。 实 例 由 PHP 脚本 编写 . 它 先 监测 手机 电池 状态 .然后 把 电池 状态 写 到 HTML 文件 
中 .最 后 启动 HTML 文件 显示 电池 状态 。 图 12-2 是 实例 运行 结果 。 
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Battery status 


Status: 2 
Temperature: 0 
Level: 50 


. 
. 
. 
es Plugged In:1 





图 12-2 电池 状态 
【 例 12-3】 (代码 位 置 : \12\htmlBattery. php) 


< ?php 
require_once(“Android. php”); 
¥ droid=new Android(); 


¥ template=“<html> < body> 

<hl> Battery Status< /hl1> 

<ul> 

<1i><strong> Status: %s</1i> 

<1i> strong> Temperature: %s</1i> 
《1i>< strong>Level: %s</li> 
《1i>< strong>Plugged In: %s</li> 
</ul> 

《</body> < /html> ”; 


// 监 测 电池 状态 
Ydroid- > batteryStartMonitoring(); 
¥result=null; 
while (¥result==null ) 
{ 
¥result=¥ droid- > readBatteryData(); 
¥result=¥ result[’ result’ ]; 
¥ droid- > eventWait (1000) ; 
} 
¥ droid- >batteryStopMonitoring () ; 
// 生 成 HTML 文件 
Yfile= fopen(“file:///sdcard/sl4a/scripts/battstats.html“，w“) ; 


Android GUI 


¥htmlContent= sprintf (¥ template, ¥ result— > status, ¥ result— 》temperature，Yresult- > 


level, ¥result- > plugged); 

fwrite(¥ file,¥htmlContent): 

fclose(Yfile) ; 

// 显 示 HTML 文件 10 秒 

Ydroid- >webViewShow( file:///sdcard/sl4a/scripts/battstats. html’ ); 
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¥ droid- > eventWait (10000) ; 
位 


下 面 是 联系 人 列表 实例 . 例 中 用 户 可 以 查看 联系 人 和 打 电 话 。 它 由 文件 
htmlContacts. php .Contacts. html 和 exit. png 组 成 。 文 件 exit. png 是 应 用 程序 的 退出 
图 标 文 件 。 文 件 htmlContacs. php 由 PHP 脚本 编写 ,其 作用 是 启动 HTML 文件 
Contacs. html 并 监听 事件 exit, 当 监 听 到 此 事件 就 结束 整个 应 用 程序 。 文 件 Contacs. 
html 由 HTML ,JavaScript 和 CSS 实现 , 它 的 主要 作用 是 显示 手机 联系 列表 ,其 界面 由 退 
出 图 标 和 联系 人 列表 构成 。 当 用 户 单 击 某 个 联系 人 时 就 启动 电话 程序 拨打 电话 。 当 用 户 
单 击 退出 图 标 就 发 送 事件 exit 给 文件 htmlContacts. php 请 求 结束 程序 。 本 例 不 仅 展 示 
了 如 何 使 用 HTML 十 JavaScript 十 CSS 方式 实现 手机 应 用 界面 ,而 且 还 展示 了 在 界面 中 
如 何 使 用 JavaScript 发 送 事 件 同 Android 系统 互动 。 

【 例 12-4】 〈 代 码 位 置 : \12\Contacts) 

文件 htmlContacts. php: 


< ?php 
require_once (“Android. php”); 
¥ droid=new Android(); 
¥droid- > webViewShow( file:///sdcard/sl4a/scripts/contacts. html’ ); 
//¥ droid- > eventClearBuffer () ; 
¥ret=¥ droid- > eventWait () ; 
¥ret=¥ ret[’ result’ ]; 
while ( (¥ret!=null ) && (¥ret-> name!= “exit”) ) 
{ 
¥ret=¥ droid- > eventWait (); 
¥ret=¥ret[’ result’ ]; 


2 


文件 contacts. html: 


<html> 
<head> 
<meta http- equiv= “content- type” content= “text/html; charset=utf-8” /> 
< /head> 
“style type= “text/css”> 
#exitBtn{ 
background- image: url (exit. png) ; 
1 
/style> 
<body> 
<img src= ”exit. png” onclick= ”exit();” /> 
《hl> 联系 人 列表 < /h1> 
《ul id= “contacts”> < /ul> 
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脚本 的 运行 方式 及 常见 错误 问题 


13.1 APK 模板 发 布 脚本 


13.1.1 APK 模板 是 什么 


Android 应 用 通常 是 以 标准 的 APK 安装 包 形 式 发 布 给 普通 用 户 的 。 脚 本 文件 如 何 
以 标准 的 Android APK 包 方 式 发 布 Android 脚本 应 用 呢 ? 谷歌 公司 提供 的 脚本 模板 系 
统 提 供 了 统一 的 方法 把 不 同类 型 的 脚本 封装 到 了 Android 应 用 ,其 支持 的 脚本 语言 类 型 多 
达 十 多 种 。 脚 本 模板 系统 是 一 个 使 用 Java 语言 编写 和 由 功能 强大 的 Eclipse 平台 支持 的 
Android 应 用 工程 ,开发 人 员 可 以 在 模板 工程 中 加 入 自己 想 加 入 的 脚本 文件 和 脚本 文件 所 需 
的 资源 ,通过 Eclipse 工具 可 以 把 模板 工程 生成 自己 的 Android 脚本 应 用 APK 安装 包 。 

13-1 是 模板 系统 执行 脚本 程序 的 工作 过 程 . 它 由 模板 系统 、 脚 本 解析 器 .SL4A 组 
件 和 外 部 存储 器 组 成 .它们 构成 了 三 层 分 层 架 构 。 当 用 户 首次 启动 模板 系统 时 ,模板 系统 
先 把 模板 系统 中 的 附加 脚本 等 资源 解压 到 外 部 存储 器 ,然后 发 送 意图 请 求 Android 系统 
启动 脚本 解析 器 执行 外 部 存储 器 中 的 脚本 .最 后 脚本 以 RPC 和 JSON 通信 方式 请 求 
SL4A 为 其 提供 原生 态 Android 服务 。 











意图 启动 脚本 
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13-1 模板 系统 执行 脚本 过 程 


13.1.2 代理 模式 下 的 模板 工作 时 序 


1994 年 ,设计 模式 莫 基 人 Erich Gamma 等 在 其 专著 Design Patterns: Elements of 
Reusable Object-Oriented Software 中 提出 了 代理 设计 模式 。 代 理 模式 是 指 为 其 他 对 象 
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提供 一 种 代理 以 控制 对 这 个 对 象 的 访问 . 它 是 一 种 结构 型 设计 模式 。 代 理 模 式 一 般 会 涉 
及 三 类 角色 : 抽象 角色 .代理 角色 .真实 角色 。 真 实 角色 是 业务 逻辑 的 具体 执行 者 。 代 理 
角色 提供 与 真实 对 象 相同 的 接口 . 它 代表 了 真实 角色 ,任何 时 刻 对 真实 角色 的 访问 都 需要 
由 代理 角色 来 完成 .代理 对 象 可 以 在 执行 真实 对 象 操作 时 附加 其 他 控制 等 操作 。 抽 象 角 
色 声 明 真 实 对 象 和 代理 对 象 的 共同 接口 。 常 见 的 代理 类 型 可 分 为 远程 代理 、 保 护 代理 、 虚 
拟 代理 ,防火 墙 代理 、 智 能 引用 代理 、 缓 存 代 理 、 同 步 代 理 和 外 观 代理 等 。 远 程 代理 为 一 个 
对 象 在 不 同 的 地 址 空间 提供 局 部 代理 ,这 样 可 以 隐藏 一 个 对 象 存在 于 不 同 地 址 空间 的 事 
实 。 代 理 设计 模式 有 三 条 重要 的 设计 要 点 : 外 在 面向 对 象 系统 中 .很 难 直 接 使 用 不 同 地 
址 空间 的 远程 对 象 ,“ 增 加 一 层 间 接 层 "作为 代理 对 象 是 解决 这 一 问题 的 常用 手段 ; 四 代 
理 的 粒度 较 灵 活 , 可 以 对 单个 对 象 做 细 粒 度 的 控制 ,可 以 对 组 件 模 块 提供 抽象 代理 层 , 可 
以 在 架构 层次 对 对 象 做 代理 ; @ 代 理 并 不 一 定 要 求 保持 接口 (抽象 角色 ) 的 一 致 性 ,只 要 
能 够 实现 间接 控制 , 损 及 一 些 透明 性 是 可 以 接受 的 。 

模板 系统 采用 远程 代理 设计 结构 。 脚本 解析 器 (或 称 脚本 引擎 ) 和 模板 系统 彼此 互相 
独立 ,两 者 程序 运行 空间 不 同 .模板 系统 是 本 地 空间 ,脚本 解析 器 处 于 远程 空间 ,模板 系统 
中 的 本 地 脚本 无 法 直接 被 脚本 解析 器 执行 。 通 过 设置 远程 代理 对 象 . 模板 系统 可 以 透明 
地 访问 脚本 解析 器 ,脚本 可 以 被 脚本 解析 器 执行 。 模 板 系统 的 代理 设计 结构 如 图 13-2 所 
示 。 代 理 模式 由 三 部 分 组 成 ,分 别 是 请 求 执行 脚本 文件 的 后 台 服 务 类 ScriptService ,提供 
代理 服务 的 组 件 script. jar 和 被 代理 的 脚本 解析 器 。 组 件 script. jar 是 谷歌 提供 的 第 三 方 
类 库 , 它 是 脚本 解析 器 的 代理 者 ,后 台 服 务 类 ScriptService 提交 的 本 地 脚本 通过 它 可 以 
透明 地 访问 远程 端的 脚本 解析 器 。 










模板 系统 


ScriptService 


真实 角色 











接口 抽象 角色 











script.jar 








代理 角色 
图 13-2 模板 的 代理 模式 


为 了 支持 脚本 后 人 台 播 放 音 乐 等 应 用 .模板 系统 统一 以 后 台 的 方式 运行 脚本 。 另 外 .模板 
系统 不 允许 多 个 脚本 并 行 运行 ,因为 那样 将 出 现 类 似 多 线程 不 可 预测 性 等 问题 。 图 13-3 揭 
示 了 代理 设计 模式 下 模板 系统 启动 脚本 的 工作 时 序 . 系 统 由 用 户 、 界 面 类 对 象 ScriptActivity 
和 DialogActivity ,控制 类 对 象 ScriptService ,实体 类 对 象 ScriptApplication 和 Script、 类 
库 script. jar 和 脚本 解析 器 等 组 成 。ScriptActivity 的 作用 是 触发 脚本 运行 , 它 是 启动 脚 
本 的 第 一 个 任务 , DialogActivity 的 作用 是 提供 脚本 启动 错误 对 话 框 ,ScriptApplication 
的 作用 是 控制 脚本 互 斥 避 免 多 个 脚本 并 行 .Script 的 作用 是 获取 脚本 主 文件 (第 一 个 被 执 
行 的 脚本 文件 ) . ScriptService 的 作用 是 让 全 部 脚本 文件 运行 在 后 台 。 其 具体 过 程 如 下 
所 述 。 
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ScriptActivity ScriptService Script 脚本 解析 器 
用 户 DialogActivity ScriptApplication scriptjar 
1. 启动 2. 查询 是 否 可 启动 后 台 服务 


ScriptService 


4. 启动 后 台 服务 。 3. 等 竺 
目 


5. 获取 脚本 主 程序 文件 名 fileName 





6. 获取 filename 脚 本 解析 器 配置 
1 是 否 识 别 脚本 和 安装 解析 器 
Ee 站 8& 不 识别 肿 本 或 不 安装 脚本 解析 器 : 
10. 复制 脚本 到 手机 内 部 存储 空间 








11. 请 求 运行 脚本 filename 





12. 运行 脚本 


图 13-3 模板 的 时 序 


(1) 当 用 户 运行 模板 系统 程序 时 .系统 首先 创建 和 执行 活动 ScriptActivity ,该 活动 主 
要 工作 有 : 中 通过 对 象 ScriptApplication 查询 后 台 服 务 ScriptService 状态 ,如 果 是 不 可 
运行 状态 则 一 直 等 待 到 可 运行 状态 ,或 者 说 .没有 脚本 程序 运行 才 允 许 启动 后 台 服 务 
ScriptService; 四 启动 后 台 服 务 ScriptService。 

(2) 后 台 服 务 ScriptService 先 向 对 象 Script 发 送 请 求 查询 脚本 主 程序 文件 名 
filename, 然 后 从 类 库 script. jar 获取 与 filename 相对 应 的 脚本 解析 器 配置 ,通过 配置 可 
识别 系统 是 否 支持 该 类 型 脚本 语言 。 如 果 不 支 持 则 转向 (3) ,否则 转向 (4)。 

(3) 启动 脚本 启动 错误 对 话 框 DialogActivity 显示 系统 不 能 为 脚本 找到 脚本 解析 器 
错误 提示 并 结束 程序 。 

(4) 继续 通过 步骤 (2) 中 的 配置 识别 系统 是 否 已 安装 脚本 解析 器 .如 果 未 安装 则 转向 
(5) ,否则 转 (7) 。 

(5) 启动 活动 DialogActivity 引导 用 户 决定 是 否 继续 下 载 和 安装 脚本 解析 器 ,如果 用 
户 选 择 “ 是 ” 则 下 载 和 安装 脚本 解析 器 .同时 结束 程序 .否则 直接 结束 程序 。 

(6) 通过 类 库 script. jar 把 目录 res/raw 中 包括 脚本 主 程序 等 资源 文件 (不 包括 子 目 
录 文 件 ) 解 压 到 手机 内 部 存储 空间 中 。 

(7) 最 后 把 脚本 主 程序 文件 提交 给 脚本 解析 器 代理 类 库 script. jar 运行 .script. jar 
会 为 脚本 选择 匹配 的 脚本 解析 器 并 由 真实 的 脚本 解析 器 运行 。 

当 类 ScriptApplication 检测 到 后 台 仍 有 脚本 程序 在 运行 时 . 则 后 台 服 务 
ScriptService 处 于 不 可 运行 状态 .否则 处 于 可 运行 状态 。 当 ScriptService 处 于 可 运行 状 
态 时 .如 有 新 脚本 申请 运行 则 后 人 台 服 务 ScriptService 转换 为 不 可 运行 状态 ; 当 
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ScriptService 处 于 不 可 运行 状态 时 .新 申请 运行 的 脚本 会 主动 结束 运行 .只 有 当 正 在 运行 
的 脚本 结束 ,后 台 服 务 ScriptService 才 可 转换 为 可 运行 状态 。 后 台 服 务 ScriptService 的 
主要 作用 是 让 脚本 程序 运行 在 后 台 。 

13.1.3 APK 模板 类 及 对 外 接口 设计 


模板 系统 的 类 和 组 件 如 表 13-1 所 示 。 
表 13-1 模板 系统 类 
类 名 类 说 明 


该 类 的 作用 是 处 理 运行 系统 未 支持 脚本 时 发 生 的 错误 。 当 系统 不 能 识别 脚本 格 
式 时 则 提示 "Cannot find interpreter for script" ; 当 能 识别 脚本 格式 但 脚本 解析 器 
未 安装 时 则 提示 脚本 解析 器 未 安装 ,并 询问 用 户 是 否 要 安装 ,如 果 用 户 选 择 安装 
则 将 自动 从 网 上 下 载 脚本 解析 器 进行 安装 ,否则 取消 运行 程序 

该 类 的 作用 是 提供 静态 方法 获取 脚本 资源 文件 的 文件 名 和 扩展 名 ,该 脚本 资源 文 
件 是 指 第 一 个 运行 的 脚本 文件 , 它 由 类 变量 ID 决定 ,文件 应 存储 于 位 置 res/raw/ 
ScriptActivity 该 类 是 程序 的 入 口 活动 .其 主要 作用 是 创建 和 启动 后 台 服 务 ScriptService 


该 类 的 作用 是 根据 脚本 扩展 名 指定 相应 脚本 解析 器 配置 .并 以 线程 同步 的 方式 解 





Dialog Activity 





Script 














SeriptApplieation | 决 脚本 程序 并 行 运行 问题 , 即 不 允许 脚本 同时 运行 
该 类 的 主要 作用 是 允许 脚本 主 程序 和 RPC 服务 器 在 后 台 运 行 ,同时 ,该 类 还 具有 
ScriptService 检测 脚本 合法 性 (文件 类 型 和 文件 大 小 等 ) 和 把 res/raw/ 资 源 文件 复制 到 手机 内 
部 空间 等 功能 
seripe jor 第 三 方 类 库 .提供 复制 脚本 .获取 脚本 配置 和 代理 脚本 运行 等 功能 





要 运行 脚本 程序 .代理 对 象 script. jar 需 把 脚本 传递 给 真实 对 象 脚本 解析 器 .由 于 脚 
本 内 容 容 量 大 、 稳 定 以 及 可 作为 外 部 资源 被 其 他 脚本 程序 引用 .因此 .系统 采用 共享 外 部 
存储 作为 代理 对 象 和 真实 对 象 接口 传递 脚本 。 其 具体 设计 内 容 有 : 四 脚本 以 资源 文件 的 
形式 封装 在 模板 系统 中 ; 四 脚本 文件 统一 存储 于 指定 的 资源 目录 res/raw; @ 模 板 系统 
把 资源 目录 res/raw 中 的 脚本 资源 解压 到 外 部 存储 器 中 的 指定 目录 /data/ data/ 模 板 程序 
包 名 /files; @ 支 持 的 脚本 数量 可 达 多 个 .但 有 且 仅 有 一 个 脚本 入 口 文件 ; @ 由 类 Script 
静态 指定 脚本 入 口 文件 .该 文件 名 为 script。 


13.1.4 APK 模板 应 用 


通过 APK 模板 可 以 把 脚本 语言 作为 APK 程序 发 布 给 最 终 用 户 使 用 ,这 比 其 他 运行 
方式 更 符合 用 户 的 使 用 习惯 。 把 脚本 生成 APK 应 用 的 主要 步骤 是 : 搭建 Eclipse 
Android 脚本 开发 环境 ; 下载 脚本 APK 模板 ;把 模板 工程 导入 Eclipse 开发 工具 ;解决 模 
板 工程 在 新 的 开发 环境 中 出 现 的 错误 ;把 脚本 加 入 模板 工程 :编译 和 运行 脚本 APK 应 用 
程序 。 下 面 是 具体 实现 过 程 。 

安装 Java SDK Eclipse 和 Android SDK 开发 工具 。Java SDK 和 Android SDK 的 安 
装 见 第 1 章 。Eclipse 可 到 官网 http://www. eclipse. org/platform 下 载 . 本 书 采用 的 
Eclipse SDK 版 本 是 4. 3. 0。 安 装 三 者 之 后 .还 需要 设置 好 Eclipse 里 的 Android SDK 环 
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境 参数 。 运 行 Eclipse 工具 后 在 菜单 栏 上 选择 Window-~Preferences 一 Android, 在 SDK 
Location 处 输入 实际 的 Android SDK 路 径 即 可 。 

脚本 模板 工程 script_for_android_template 可 到 网 站 http://pan. baidu. com/s/ 
lbnNEtC7 下 载 。http://android-scripting. googlecode. com/hg/android/script _ for 


android_template. zip 是 官网 下 载 地 址 ,但 受 谷歌 网 站 影响 .官网 下 载 存 在 下 载 困难 现象 。 
在 Eclipse 中 导入 script_for_android_template 模板 工程 。 打 开 Eclipse, 在 菜单 栏 上 
选择 File-~Import-General-~Existing Projects into Workspace-~Select archive file 输 


入 模板 工程 文件 , 单 击 Finish 按钮 完成 模板 工程 导入 。 图 13-4 是 导入 模板 工程 的 界面 。 





Import projects 
Select a directory to search for existing Eclipse projects. [= 
© Select root directory: “|[ Browse- 
@select archive file: CAAndroid\script forandroid templatezip ~ [Browsew 
Projects: 
ScriptforAndroidTemplate 0 Seleat Al 





























Opsons 
回 Ssearch for nested projects 
回 Copy projects into workspace 






































Working sets 
回 Add project to working sets 
Norking set Select- 
@ sk Nen Finish Cancel 
ee 





图 13-4 导入 模板 工程 


导入 模板 工程 后 .如 果 在 Eclipse 控制 台 上 出 现 Unable to resolve target android-4” 
此 类 错误 则 说 明 API 需要 重新 修改 。 打 开工 程 目录 下 的 project. properties 文件 把 
target 一 android-4 修改 为 target 一 android-14。 因 为 这 里 的 Android SDK 所 使 用 的 API 
版 本 为 14 而 不 是 4. 所 以 需要 把 工程 中 的 4 修改 为 14。 读 者 可 根据 自己 的 情况 来 修改 版 
本 。 保 存 工程 后 按 F5 键 重新 刷新 工程 或 重新 打开 工程 即 可 消除 错误 。 13-5 是 API 
不 匹配 错误 提示 . 右 下 角 是 错误 提示 文字 。 

如 果 出 现 R. java: No such file or directory 此 类 错误 . 那 就 删除 这 个 R. java 文件 。 
删除 这 个 R. java 文件 后 ,Eclipse 会 自动 生成 一 个 更 新 的 R. java 文件 。 如 果 没 有 错误 出 
现 .表明 此 时 的 模板 工程 已 成 功 导 入 。 

之 后 可 以 把 模板 工程 名 和 包 名 改 成 自己 的 工程 名 和 包 名 。 右 击 模板 工程 弹出 菜单 ， 
如 果 选 择 Refactor 一 Rename 菜单 项 则 可 以 修改 工程 名 :如果 选择 Android Tools 一 
Rename Application Package 菜单 项 则 可 以 修改 包 名 。 
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Ne El Refactor Navigae Search projert Run Wndow Re 











Package Erplorer 安 晶 乞 7” 前 project.properties 3 
所 SaiptForAndroidTemplate # This File is autematically Screrated by Android Tools. 
i # Do not modify this File -- YOLR CHANGES UTLL BE sRASED! 


b Bi Referenced Libraries 


# This file must be checked in Version Control Systems。 






roperties used by the Ant bulld system use, 
and override values to adapt the script to your 














pres 
BY AndroidManifestaml 
局 build properties 
园 baldxml 
configure_package.sh 5 
国 lecalproperties 
目 projecrpropenies 
罩 README 





Decarauor 回 Console 3 





SriptForRAnaroidTeapIRtE] Urable to resolve tarEeE ‘ondroid 4 

ScriptForandroidTemplate] Unable to resolve target ‘android-4 

ScriptrorandroidTemplate] WARNING; uneble to write jarlist cache fi 

ScriptForAndroidTemplate] WRNING: unable to write jarlist cache fi 

ScriptForandroidTemplate] Unable to resolve target “android-4 

- ScriptrorandroidTemplate] MARNING: unable to write jarliat ceche fl 

ScriptForandroidTmp1ate] Unable to resolve target ‘android 

~ scrdprrorandroldTeaplare] MARNING: unaole to write jarlist cache f4| 
riptForAndroidTemplate] Unable to resolve target “android-4° 

- ScriptForandroidTemplate] WARNTNG: unanle to write jarlist cache fi 


图 13-5 API 不 匹配 错误 提示 











接 下 来 把 脚本 加 入 模板 工程 。 打 开 模 板 工程 的 res/raw 目录 ,会 发 现 里 面 存储 了 脚 
本 文件 script. py。 这 是 模板 工程 自 带 的 Python 脚本 文件 ,可 以 使 用 Python 语言 在 这 个 
文件 中 直接 编写 Python 脚本 代码 。 如 果 使 用 的 脚本 不 是 Python 语言 ., 则 需 把 自己 的 肢 
本 文件 存储 到 res/raw 目录 中 .同时 .把 工程 模板 文件 src/com/dummy/fooforandroid/ 
Script. java 中 的 代码 行 public final static int ID 一 R. raw. script 修改 为 public final static 
int ID 一 R. raw. xxx, 这 里 的 “xxx” 是 指 新 加 入 脚本 的 文件 名 ,文件 名 不 包括 扩展 名 。 当 
这 个 脚本 应 用 运行 时 ,这 个 脚本 文件 将 自动 运行 ,而 且 是 所 有 脚本 的 入 口 。 

接 下 来 和 Android Java 程序 一 样 ,需要 设置 模板 工程 中 的 AndroidManifest. xml 文 
件 声明 程序 将 使 用 到 的 权限 .例如 WiFi 蓝牙 和 打 电 话 权 限 。AndroidManifest. xml 内 容 
如 图 13-6 所 示 , 其 默认 已 设置 android. permission. INTERNET 权限 ,如 需 其 他 权限 只 需 
把 权限 的 注释 删 掉 即 可 。 





uses-permission 


android:name="android. permission. INTERNET”™ /> 





<!-- <uses-permission 

android:name="android,. permission.VIBRATE™ /> --> 
<1-- <uses-permission 
android:name=”android.permission.ACCESS_CHECKIN_PROPERTIES"/》 --> 
<!-- <uses-permission 

android:name="android. permission.ACCESS_COARSE_LOCATION"/> --> 
<1-- <uses-permission 
android:name="android.permission.ACCESS_FINE_LOCATION*/> --> 
<!-- <uses-permission 

android:name="android. permission.ACCESS_LOCATION_EXTRA_COMMANDS"/> --> 
<1-- <uses-permission 
android:name="android.permission.ACCESS_MOCK_LOCATION"/> --> 
<!-- <uses-permission 


android;name="android.permission-ACCESS_NETWORK_STATE"/>》 --> 





图 13-6 文件 AndroidManifest. xml 


要 编译 ,打包 和 运行 脚本 APK 程序 .还 需 右 击 模板 工程 名 选择 菜单 项 Run As 一 
Android Application。 要 在 PC 上 运行 程序 还 需要 添加 Android 模拟 器 。 也 可 以 把 模板 
工程 bin 目录 中 的 APK 文件 安装 到 手机 中 运行 。 


Android 脚本 应 用 开发 技术 


13.2 二 维 码 发 布 脚 本 


虽然 开发 人 员 可 以 在 手机 端 编写 脚本 程序 .但 手机 端的 开发 工具 通常 没有 智能 感知 
和 关键 字 自动 补 全 等 功能 ,而 且 键 盘 输入 区 域 狭小 容易 出 现 按键 失误 .这 使 在 手机 端 编写 
脚本 成 为 一 项 很 辛苦 的 工作 。 好 的 做 法 是 先 在 PC 端 编 好 代码 再 下 载 到 手机 端 运 行 。 如 
何 快速 地 将 PC 上 编写 的 代码 发 送 到 手机 上 呢 ? 常用 的 方法 是 用 USB 数据 线 或 WiFi 把 
代码 下 载 到 手机 端 ,前 者 需要 带 线 操作 ,后 者 需要 PC 和 手机 同属 同一 网 络 ,在 把 代码 发 
布 给 其 他 用 户 或 开发 人 员 时 ,其 显得 操作 很 烦琐 和 带 有 安全 等 问题 。 借助 二 维 码 发 布 脚 
本 可 以 解决 这 些 问题 。 

二 维 码 发 布 脚本 程序 主要 过 程 : 首先 开发 人 员 在 PC 端 编写 好 脚本 程序 ,然后 利用 二 
码 维 生 成 工具 为 脚本 代码 生成 二 维 码 图 片 把 程序 发 布 出 去 .再 然后 用 户 通过 SL4A 扫描 
二 维 码 图 片 自动 从 图 片 中 识别 出 代码 并 下 载 到 手机 端 ,最 后 用 户 通过 SL4A 运行 下 载 的 
脚本 程序 。 把 脚本 代码 生成 二 维 码 . 具 体 过 程 如 下 所 示 。 

(1) 打开 二 维 码 在 线 生 成 页 面 ,如 http://qrcode. cnaidc. com/ ,设置 二 维 码 数据 为 文 
本 类 型 ; 

(2) 在 二 维 码 文本 框 的 第 一 行 输入 脚本 的 名 称 ,比如 HelloWorld. js; 

(3) 在 二 维 码 文本 框 的 第 二 行 及 其 下 面 行 输入 脚本 代码 ; 

(4) 生成 二 维 图 图 片 .将 生成 的 二 维 码 图 分 享 给 相关 开发 人 员 。 

把 赃 在 二 维 码 中 的 脚本 代码 导入 手机 端的 具体 过 程 如 下 所 示 。 

(1) 启动 手机 端的 应 用 程序 SL4A 进入 脚本 列表 主 界面 ; 

(2) 点 按 (或 长 按 ) 菜单 键 (MENU) ,选择 Add-~Scan Barcode 菜单 项 启动 二 码 维 
应 用 ; 

(3) 扫描 二 维 码 .SL4A 会 自动 存储 脚本 代码 文件 ,脚本 文件 以 前 述 的 第 一 行文 本 命 
名 ,并 显示 在 SL4A 脚本 列表 中 ; 

(4) 单 击 SL4A 脚本 列表 中 的 脚本 文件 即 可 运行 程序 。 

由 于 二 维 码 最 多 容纳 的 字符 为 4296 个 ,所 以 这 种 方法 只 能 用 来 存储 代码 较 短 的 脚 
本 。 另 外 ,需要 在 手机 端 预 安装 好 SL4A 和 ZXing 二 维 码 扫描 程序 。 


13.3 ”SL4A 管理 脚本 


SL4A 不 仅 可 以 为 脚本 提供 Android 原生 态 服务 ,而 且 还 提供 脚本 编辑 .运行 .调试 
等 功能 ,以 及 提供 脚本 引擎 ,Shell 控制 台 、 脚 本 运行 终端 等 管理 功能 。 

从 Android 桌面 运行 SL4A 应 用 后 .其 首先 显示 的 是 脚本 列表 主 界面 。 在 主 界面 中 
单 击 脚本 项 目 会 弹出 一 个 菜单 .每 个 菜单 项 用 一 个 图 标 表 示 ., 莱 单项 从 左 到 右 依次 分 别 是 
run foreground run background edit ,rename delete 和 external editor。run foreground 
表示 以 终端 方式 运行 脚本 ,这 种 方式 比较 适合 脚本 调试 . 当 脚 本 出 错时 可 以 通过 终端 查看 
错误 信息 。run background 以 后 台 方 式 运 行 脚本 .通常 用 户 都 使 用 这 种 方式 运行 脚本 。 
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edit 的 作用 是 让 开发 人 员 使 用 SL4A 文本 编辑 器 编写 脚本 代码 ,由 于 这 种 编辑 器 没有 像 
PC 端 代码 编辑 器 那样 提供 自动 错误 提示 和 智能 补 全 等 功能 ,再 加 上 没有 物理 键盘 和 屏 
幕 尺 寸 小 等 原因 ,因此 SL4A 文本 编辑 器 并 不 好 使 用 。rename 可 以 为 脚本 文件 重 命名 。 
delete 用 于 删除 脚本 文件 。external editor 可 以 让 开发 人 员 使 用 外 部 编辑 器 编辑 代码 。 

在 主 界面 中 点 击 或 长 按 Menu 按钮 会 在 屏幕 底部 出 现 一 个 菜单 .菜单 中 含有 Add、 
View、Search、Preferences、Refresh 和 Help 菜单 项 。Add 的 作用 是 新 建 脚本 ,包括 新 建 
HTML 脚本 JavaScript 脚本 、PHP 脚本 .Python 脚本 和 Shell 脚本 ,以 及 扫描 二 维 码 创 
建 脚本 。View 的 作用 是 跳 转 到 Interpreters、Triggers 和 Logcat 页 面 .在 Interpreters 页 
面 中 可 以 添加 脚本 引擎 和 启动 Shell 等 应 用 ;在 Trigers 页 面 中 设置 脚本 运行 触发 条 件 ， 
条 件 可 以 是 信号 强 弱 、 打 电话 和 电源 量 小 等 。Search 的 作用 是 搜索 脚本 。Preferences 用 
来 设置 首选 项 。Refresh 用 来 重 载 脚 本 列表 。Help 的 作用 是 显示 SL4A API 等 相关 
帮助 。 

Preferences 是 最 常用 的 菜单 项 . Preferences 可 以 对 General (常规 项 )、Script 
Manager( 脚 本 管理 器 ) .Script Editor( 脚 本 编辑 器 ) 和 Terminal( 终 端 ) 等 首选 项 进行 设 
置 。 单 击 Preferences 菜单 项 后 会 跳出 一 个 对 话 框 ,这 个 对 话 框 中 列 出 了 这 些 首 选项 的 具 
体 设置 。General 常规 项 包括 Usage Tracking 和 Server Port 选项 ,前 者 允许 收集 匿名 的 
Google 分 析 统 计 . 后 者 设置 SL4A 服务 器 端口 ,如 果 值 为 零 则 随机 选用 端口 ,但 不 建设 使 
用 常用 端口 ,例如 80 端口 。Script Manager 包含 Show All Files 首选 项 设置 , 它 允 许 显 示 
全 部 文件 ,包括 未 知 类 型 的 文件 。Script Editor 包含 Font Size、Force API Browser、 
Enable Auto Close、No Wrap、Auto Indent 等 首选 项 。Font Size 用 于 设置 编辑 器 字体 ， 
开发 人 员 可 以 依据 屏幕 大 小 设置 此 值 。Force API Browser 可 以 设置 使 用 Android 浏览 
器 查看 SL4A API 帮助 。Enable Auto Close 允许 编辑 器 自动 补 全 括号 和 双 引 号 ,开发 人 
员 如 果 感觉 不 方便 可 以 关闭 该 功能 。No Wrap 用 来 设置 是 否 自动 换行 ,如 果 选 中 则 表示 
即使 一 行 代码 很 长 也 不 会 自动 换行 。Auto Indent 用 来 设置 新 行 是 否 自 动 缩 进 .打开 此 项 
将 使 新 行 根据 前 面 行 自动 缩 进 。Terminal 比较 常用 的 首选 项 有 Scrollback Size、Font 
Size、Encode、Full Screen 等 。Scrollback Size 表示 终端 缓存 大 小 ,如 果 终 端 内 容 较 多 而 缓 
存 值 较 小 , 则 开发 人 员 可 能 会 看 不 到 部 分 输出 内 容 , 开 发 人 员 可 以 根据 开发 需要 设置 此 
值 。Font Size 用 于 设置 终端 字体 大 小 .可 以 根据 屏幕 大 小 设置 此 值 。Encode 用 来 设置 
终端 字体 的 编码 。Full Screen 可 以 隐藏 状态 栏 使 终端 占用 整个 屏幕 。 


13.4 _ Androi 脚本 中 文 编码 问题 


JavaScript 默认 支持 ASCII 编码 而 没有 支持 中 文 编码 .如 果 在 代码 中 出 现 了 中 文 . 那 
么 运行 结果 将 显示 乱码 。 为 了 能 让 JavaScript 支持 中 文 编码 ,需要 修改 手机 端 文 件 
json2. js 和 android. js。 这 两 个 文件 存储 在 目录 /mnt/sdcard/com. googlecode. 
rhinoforandroid/extras/rhino。 把 文件 json2.js 第 370 行 处 代码 做 修改 使 其 能 支持 汉字 
编码 。json2. js 修改 前 代码 如 下 所 示 。 
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// escapable=/[\” \u0000— \u001f\u007f- \u009f\u00ad\u0600- \u0604\u070f \ul7b4\ul7b5\ 
u200c- \u200f\u2028- \u202f\u2060- \u206f\ufeff\ufff0- \uffff]/g; 


json2. js 修改 后 代码 如 下 所 示 。 


escapable=/[\”\u0000- \u001f\u007f- \u009f\u00ad\u0600- \u0604\u070f\ul7b4\ul7b5\u200c 
— \u200f \u2028- \u202f\u2060- \u206f\ufeff\ufff0- \uffff\u0391- \uffe5]/g; 


其 在 代码 行 尾 处 加 入 值 *u0391-\uffe5”, 其 为 汉字 的 Unicode 最 小 值 和 最 大 值 ,加 入 
这 个 值 后 ,系统 会 把 这 个 范围 的 值 转 为 Unicode 编码 。 同 时 还 需要 把 文件 json2. js 和 
android.js 的 文件 编码 设 为 ASCII, 具 体 做 法 是 在 phpDesigner 工具 中 打开 这 两 个 文件 ， 
在 菜单 中 选择 “文件 ”>“ 文 件 编码 ”-~ANSI 设置 文件 编码 ,保存 好 文件 后 把 这 两 个 文件 
复制 覆盖 手机 中 的 对 应 文件 即 可 。 除 此 ,JavaScript 脚本 文件 的 文件 编码 要 设置 为 UTF- 
8, 具 体 做 法 是 在 phpDesinger 工具 菜单 中 选择 “文件 ”>“ 文 件 编码 ”一 UTF-8。 

默认 的 PHP 是 支持 中 文 编码 的 ,但 PHP 脚本 文件 的 文件 编码 需要 设置 为 UTF-8， 
文件 格式 要 设置 为 UNIX。 具 体 做 法 是 在 phpDesigner 工具 菜单 中 选择 “文件 ”->“ 文 件 
编码 ”~UT-8 和 “文件 ”->“ 文 件 格式 ”~UNIX。 


13.5 ”Andwid 环境 搭建 不 能 访问 谷歌 网 站 问题 


13.5.1 环境 搭建 失败 问题 


Android 脚本 引擎 是 搭建 Android 脚本 运行 环境 关键 所 在 ,因为 Android 脚本 引擎 
在 安装 过 程 中 需要 从 谷歌 网 站 下 载 相关 文件 ,但 由 于 谷歌 网 站 在 国内 存在 访问 速度 慢 等 
问题 ,因此 Android 脚本 引擎 安装 容易 出 现下 载 不 了 文件 或 下 载 时 间 过 久 导 致 下 载 失败 。 
针对 这 个 问题 .本 节 探 讨 利 用 Web 域名 重 定位 技术 搭建 Android 脚本 运行 环境 ,可 避免 
因 谷歌 网 站 造成 环境 搭建 失败 问题 。 


13.5.2 Web 搭建 Android 环境 原理 


Android 脚本 运行 环境 搭建 原理 如 图 13-7 所 示 . 图 由 Android 手机 和 Web 服务 器 两 
部 分 组 成 ,其 中 ,Android 手机 由 SLAA 、Android 脚本 引擎 和 系统 文件 hosts 组 成 ,手机 通 
过 文件 hosts 把 谷歌 网 站 重 定位 向 自 搭建 的 Web 服务 器 .Android 脚本 引擎 通过 HTTP 
可 从 Web 服务 器 下 载 文 件 自动 完成 安装 工作 ;Web 服务 器 为 Android 脚本 引擎 提供 文 
件 下 载 服务 。 环 境 搭 建 主要 步骤 : 四 下 载 环 境 搭建 相关 软件 ,包括 SL4A、PHPNow、 
Android 脚本 引擎 和 脚本 引擎 文件 列表 等 ; @ 在 PC 端 安装 PHPNow Web 服务 器 ; @ 把 
脚本 引擎 文件 列表 部 署 到 Web 服务 器 ; 四 修改 手机 的 hosts 文件 使 谷歌 域名 重 定向 到 自 
搭建 的 Web 服务 器 ; @ 在 手机 端 安装 SL4A 和 Android 脚本 引擎 ; @ 运 行 Android 脚本 
引擎 应 用 从 Web 服务 器 下 载 文件 和 完成 安装 。 

SL4A、Android 脚本 引擎 和 脚本 引擎 文件 列表 可 到 谷歌 官方 网 站 下 载 ,但 谷歌 网 站 
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和 脚本 引擎 
Android JavaScript 引 擎 下 载 文 件 列表 hosts 文 件 






































图 13-7 运行 环境 搭建 原理 


经 常 出 现 访问 失败 问题 ,建议 到 非 官 方 网 站 http://pan. baidu. com/s/lmgknrja 下 载 。 
Android 脚本 引擎 要 下 载 的 文件 需要 复制 到 “Web 服务 器 主 目录 \files 子 目录 ”中 。 关 于 
Android PHP 和 JavaScript 脚本 引擎 要 下 载 的 文件 列表 请 参看 第 1 章 内 容 。PHPNow 
套件 可 从 官方 网 站 http://servkit. org/download/ 下 载 。 

Android 中 用 于 域名 定位 的 hosts 文件 存储 在 手机 /system/etc 目录 中 ,通过 修改 该 
文件 可 让 Android 系统 访问 指定 域名 时 重 定向 访问 PC 端 Web 服务 器 。 文 件 hosts 存储 
了 网 站 域名 和 IP 地 址 的 映射 关系 ,每 个 映射 关系 用 一 行 记 录 表 示 , 每 行 记录 的 具体 格式 
是 “IP 地 址 网 站 域名 ”, 比 如 192. 168. 1. 1 www. google. com, 当 访问 域名 www. google. 
com 时 ,将 访问 IP 为 192. 168. 1. 1 的 服务 器 。 


13.5.3 ”环境 搭建 过 程 


搭建 Web 服务 器 。 先 把 PHPNow 套件 解压 到 PC 端 某 个 目录 中 ,比如 解压 目录 为 
C:\PHPNow; 然 后 执行 解压 目录 中 的 Setup. cmd 命令 文件 .该 命令 文件 执行 过 程 会 以 命 
令 方 式 提示 用 户 选择 Apache 服务 器 和 MySQL 数据 库 选 项 ,以 及 设置 MySQL 用 户 密 
码 ; 用 户 按 提示 选择 和 设置 好 密码 后 .系统 会 自动 搭建 好 一 个 Apache 十 PHP 十 MySQL 
环境 。 要 测试 Web 服务 器 是 否 已 安装 成 功 ,可 在 浏览 器 中 输入 http://127. 0. 0.1/, 如 果 
能 显示 PHPNow 主 界面 表明 环境 搭建 成 功 ,否则 表示 失败 。 图 13-8 是 PHPNow 主 
界面 。 

部 署 Android 脚本 引擎 下 载 文件 列表 。 先 在 PHPNow 主 界面 中 查看 “网 站 主 目录 ” 
项 ,此 处 为 C:/PHPnow-1.5.6/htdocs。 再 在 网 站 主 目录 中 建立 子 目录 files。 最 后 再 把 
Android 脚本 引擎 下 载 文 件 列 表 复 制 到 目录 C:\PHPnow-1. 5. 6\htdocsNfiles 中 。 

修改 手机 端 hosts 文件 快速 定位 域名 。 可 下 载 Hosts Editor 和 “Hosts 管理 Hosts” 
等 应 用 (拥有 root 权限 最 好 ) 修 改 hosts 文件 。 把 下 面 两 行 添加 到 hosts 文件 尾 端 ,其 表 
示 把 Android PHP 引擎 要 访问 的 android-scripting. googlecode. com 和 android- 
scripting. googlecode. com 域名 重 定向 到 IP 为 192. 168. 1. 1 的 Web 服务 器 。 如 果 要 把 
其 他 脚本 引擎 要 访问 的 域名 重 定向 到 自 设 定 的 Web 服务 器 , 则 需 把 php-for-android. 
googlecode. com 修改 成 相应 的 域名 即 可 。 例 如 .rhino-for-android. googlecode. com 表示 
JavaScript 引擎 要 访问 的 域名 。 
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Server Information 





SERVER_NAME 


127.0.0.1 





SERVER_ADDR:PORT 





127.0.0.1:80 





SERVER_SOFTWARE 


Apache/2.2.16 (Win32) PHP/5.2.14 




















PHP_SAPI | apache2handler 
php.ini | C:\PHPnow-1.5.6\php-5.2.14-Win32\php-apache2handler.ini 
网 站 主 目录 | C:/PHPnow-1.5.6/htdocs 
Server Date / Time | 2015-05-26 15:54:49 (+ 
Other Links | phpinfo() | phpMyAdmin 











Zend Optimizer | No 





MySQL 支持 | Yes / client lib version 5.0.90 





GD library | Yes /bundled (2.0.34 compatible) 





eAccelerator | No 















































MySQL 连接 玛 试 
MySQL 服务 器 ocalhost | MySQL 数据 库 名 est 
MySQL 用 户 名 [root | MySQL 用 户 密码 




















连接 








图 13-8 PHPNow 主 界面 


192. 168. 1.1 android- scripting. googlecode. com 
192. 168. 1.1 php- for-android. googlecode. com 


在 手机 端 安装 SL4A 和 Android 脚本 引擎 APK 应 用 。 之 后 在 手机 中 单 击 Android 
脚本 引擎 图 标 进入 安装 界面 并 单 击 Install 按钮 将 自动 从 Web 服务 器 下 载 文件 列表 和 完 
9 对 Android PHP 引擎 下 载 文件 列表 的 正常 和 异常 状态 进行 
了 比较 .其 中 .图 13-9(a) 是 正常 安装 解压 过 程 ,图 13-9(b) 是 等 待 下 载 过 程 ,网 络 超时 后 


成 后 面 的 安装 工作 。 13- 


将 导致 安装 失败 。 


@@ Extracing 


php_r3zip 


(a) 正 





©@ Downloading 


php_r3zip 








常 下 载 解压 (b) 等 待 下 载 


13-9 Android PHP 引擎 安装 过 程 比较 
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13.6 Andid 网 络 缓存 带 来 的 问题 


当 PHP 脚本 调用 SL4A 方法 查询 Android 系统 的 包 列 表 和 包 的 类 列表 时 ,其 返回 的 
包 和 类 列表 会 很 长 ,而 且 包 名 和 类 名 也 比较 长 。 如 果 存 储 包 和 类 的 缓存 长 度 不 够 ,那么 脚 
本 应 用 可 能 会 丢失 数据 甚至 出 现 错误 。 通 过 修改 文件 Android. php 的 缓存 长 度 可 以 解 
决 这 个 问题 。 这 个 文件 存储 在 手机 目录 /mnt/sdcard/com. irontec. phpforandroid/ 
extras/php 中 。 打 开 文 件 Android. php 找到 下 面 的 代码 行 。 


¥response= socket_read(¥ this—- >_socket, 1024, PHP_NORMAL_ READ) or die (“Could not read 
input\n”); 


原来 的 缓存 长 度 是 1024B, 可 根据 自己 的 需要 把 这 个 长 度 修改 为 合适 的 值 ,此 处 修改 
为 1024X5B。 修 改 后 代码 行 如 下 所 示 。 


¥response = socket read (¥this— > _ socket，1024 * 5，PHP _ NORMAL _ READ) or die 
(“Could not read input\n”); 


对 于 JavaScript 脚本 可 修改 文件 Android.js 的 缓存 长 度 解决 数据 丢失 问题 ,此 文件 
存储 在 手机 目录 /mnt/sdcard/com. googlecode. rhinoforandroid /extras/rhino 中 。 打 开 
文件 Android.js 找到 下 面 代 码 行 。 


this. input= new java. io.BufferedReader( 
new java. io. InputStreamReader (this. connection. getInputStream(), “8859_1”), 
1<<13) 


this.output=new java. io.PrintWriter (new java. io. QutputStreamWriter( 
new java. io. BufferedOutputStream(this. connection. getOutputStream()， 
1<<13) 


原来 的 缓存 长 度 是 8192KB(1 一 二 13) ,可 根据 自己 的 需要 把 这 个 长 度 修改 为 合适 
的 值 。 
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